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Preface 



What as Provides 



Scope of This Manual 



Audience 



This manual is the Programmer’s Reference Manual for as — the assembler for 
Sun-3 workstation running the SunOS operating system, as converts source pro- 
grams written in assembly language into a form that the linker utility, ld{ 1) will 
turn into a runnable program. 

as provides assembly language programmers with a minimal set of facilities to 
write programs in assembly language. Since most programming is done in high- 
level languages, as doesn’t provide any elaborate macro facilities or conditional 
assembly features. It is assumed that the volume of assembly code produced is 
so small that these facilities aren’t required. If they are needed, you can use the 
C preprocessor (see cpp(l)) to provide them. 

This manual describes the syntax and usage of the as assembler for the 
MC68020 and MC68030 microprocessors, the MC6888 1 floating-point coproces- 
sor, and Sun’s Floating-Point Accelerators (FPA and FPA+). The basic format of 
as is loosely based on the Digital Equipment Corporation’s Macro- 1 1 assembler 
described in DEC’S publication DEC- 1 1-OMACA-A-D. It also contains elements 
of the UNIXt PDP-11 as assembler. The instruction mnemonics and effective 
address format are based on a Motorola publication on the MC68000: the 
MACSS MC68000 Design Specification Instruction Set Processor dated June 30, 
1979. 

This is a reference manual as opposed to a treatise on writing in assembly 
language. It assumes that you are familiar with the concepts of machine 

t UNIX is a registered trademark of AT&T. 
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Preface — Continued 



Further Reading 



architecture, the reasons for an assembler, the ideas of instruction mnemonics, 
operands, and effective address modes, and assembler directives. It also assumes 
that you are familiar with the relevant processors, their instruction sets and 
addressing modes, and especially their irregularities. 

Motorola MC68020 32-bit Microprocessor Users Manual. 

Motorola MC68030 32-bit Microprocessor User’ s Manual. 

Motorola MC6888 1 Floating-Point Coprocessor User s Manual. 






Introduction 



1.1. Using the Assembler By convention, the assembly language source code of the program should be in 

one or more files with a . s suffix. Suppose that your program is in two files 
called parts . s and rest . s. To run the assembler, type the command: 




as runs silently (if there are no errors), and generates a file called a . out, unless 
the -o option is used. 

as also accepts several command-line options. These are: 

-o file Place the output of the assembler in file instead of a.out. 

-m68010 This is the default on Sun-2 systems. Accept only the MC680 10 
instruction set and addressing modes. This also puts the MC68010 
machine type tag into the output file. 

-m68020 This is the default on Sun-3 systems. Accept the full MC68020, 

MC68030, MC6888 1, and Sun FPA and FPA+ instruction sets and 
addressing modes. Includes the MC68010 instruction set and 
addressing modes as a subset, and also puts the MC68020 machine 
type tag into the output file. 



-k Generate position-independent code as required by 




Don’t apply the -k flag to hand-coded assembler programs unless they are writ- 
ten to be position-independent. 

-O Perform span-dependent instruction resolution over each entire file, 

rather than just over each procedure (see the description of the 
. proc pseudo-operation in Chapter 5). 

-R Make initialized data segments read-only (actually the assembler 

places them at the end of the .text area). 

The -R flag should not be used in any program that uses the . stabx directive. 
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Warning 



Warning 





-L Keep local (compiler-generated) symbols that start with the letter L. 

This is a debugging feature. If the -L option is omitted, the assem- 
bler discards those symbols and does not include them in the symbol 
table. 

- j Make all jumps to external symbols ( j sr and jmp) 

PC-relative rather than long-absolute. This is intended for use when 
the programmer knows that the program is short, since it only per- 
mits jumps (forward or back) up to 32K bytes long. If there are any 
externals which are too far away, the loader will complain when die 
program is linked. 

- J Suppress span-dependent instruction calculations and force all 

branches and calls to take the most general form. This is used when 
assembly time must be minimized, but program size and running 
time are not important. It must be used by any program that uses the 
. align 4 or . align 8 directives. 

-h Suppress span-dependent instmction calculations and force all 

branches to be of medium length, but all calls to take the most gen- 
eral form. This is used when assembly time must be minimized, but 
program size and running time are not important. This option results 
in a smaller and faster program than that produced by the -J option, 
but some very large programs may not be able to use it because of 
the limits of the medium-length branches. 

-d2 This is intended for small stand-alone programs. The assembler 

makes all program references PC -relative and all data references 
short-absolute. Note that the - j option does half this job. 

You should also consult the SunOS Reference Manual entry on as. 



The notation used in this manual is a somewhat modified Backus-Naur Form 
(BNF). A string of characters on its own stands for itself, for example: 




is an occurrence of the literal constant 1983. An element enclosed in < and > 
signs is a nonterminal symbol, and must eventually be defined in terms of some 
other entities. For example, 



<identifier> 

V > 



stands for the syntactic construct called ‘identifier’, which is eventually defined 
in terms of basic objects. A syntactic object followed by an ellipsis: 



microsystems 



Revision A of 27 March, 1990 







Chapter 1 — Introduction 3 




denotes one or more occurrences of <thing>. 
Syntactic objects occurring one after the other, as in: 




simply means an occurrence of first thing followed by second thing. Syntactic 
elements separated by a vertical bar sign ( | ), as in: 




mean an occurrence of <letter> or <digit> but not both. Brackets and braces 
define the order of interpretation. Brackets also indicate that the syntax 
described by the subexpression they enclose is optional. That is: 




denotes zero or one occurrences of <thing>, while { and } are used for grouping 
so that 




denotes a <thing one> or a <thing two, followed by a <thing three>. 
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Elements of Assembly Language 



This chapter covers the lexical elements which comprise an assembly language 
program. (Chapter 3 discusses the rules for expression and operand formation.) 
Topics covered in this chapter are: 

□ The character set that the assembler recognizes, 

□ Rules for identifiers and labels, 

□ Syntax for numeric constants, 

□ Syntax for string constants, 

□ The assembly location counter. 

An assembly language program is ultimately constructed from characters. Char- 
acters are combined to make up lexical elements or tokens of the language. Com- 
binations of tokens form assembly language statements, and sequences of state- 
ments form an assembly language program. This section describes the basic lexi- 
cal elements of as. 

2.1. Character Set as recognizes the following character set: 

□ The letters A through Z and a through z . 

□ The digits 0 through 9. 

□ The ASCII graphic characters — the printing characters other than letters 
and digits. 

o The ASCII non-graphics : space, tab, carriage return, and newline (also 
known as linefeed). 

2.2. Identifiers Identifiers are used to tag assembler statements (where they are called labels), as 

location tags for data, and as the symbolic names of constants. 

An identifier in an as program is a sequence of from 1 to 255 characters from the 
set: 

□ Upper case letters A through z. 

□ Lower case letters a through z . 

□ Digits 0 through 9. 



#sun 
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a The characters underline (_), period ( . ), and dollar sign ( $). 

The first character of an identifier must not be numeric. Other than that restric- 
tion, there are a few other points to note: 

□ All characters of an identifier are significant and are checked in comparisons 
with other identifiers. 

□ Upper case letters and lower case letters are distinct, so that 
kit_of_parts and KIT_OF_PARTS are two different identifiers. 

□ The period ( .) and dollar sign ( $) characters are reserved for special pur- 
poses (pseudo-ops, for instance) and should not appear in user-defined 
identifiers. 



Here are some examples of legal identifiers: 



f — 


Grab Hold 


A 




Widget 

Pot_of_Message 

MAXNAME 




V 




J 



A numeric label is a digit (0 trough 9). As in the case of alphanumeric labels, a 
numeric label assigns the current value of the location counter to the symbol. 
However, several numeric labels with the same digit may be used within the 
same assembly. References of the form nb refer to the first numeric label named 
n backwards from the reference; nt refers to the first numeric label named n 
/orwards from the reference. 

Local labels are a special form of identifier which are strictly local to a control 
section (see Section 5.4). Local labels provide a convenient means of generating 
labels for branch instructions and such. Use of local labels reduces the possibil- 
ity of multiply defined labels in a program, and separates entry point labels from 
local references, such as the top of a loop. Local labels cannot be referenced 
from outside the current assembly unit. Local labels are of the form n$ where n 
is any integer. Valid local labels include: 



r 


1$ 


■\ 




27$ 






394$ 




l 




J 



2.5. Scope of Labels The scope of a label is the ‘distance’ over which it is visible to other parts of the 

program which may reference it. An ordinary label which tags a location in the 
program or data is visible only within the current assembly. An identifier which 
is designated as an external identifier via a . globl directive is visible to other 
assembly units at link time. 

Local labels have a scope, or span of reference, which extends between one ordi- 
nary label and the next. Every time an ordinary label is encountered, all previous 



2.3. Numeric Labels 



2.4. Local Labels 
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local labels associated with the current location counter are discarded, and a new 
local label scope is created. The following example illustrates the scopes of the 
different kinds of labels: 





first : 


addl 


dO , dl 


| creates a new local label scope 


100$: 


addqw 

bees 


#7 , d3 
100$ 


| first appearance of 100$ 

| branches to the label above 


second: 


andl 


#0x7f f , d4 


| above 100$ has gone away 


100$: 


empw 

beqs 


dl, d3 
100$ 


| this is a different 100$ 

| branches to the previous instruction 


third: 


movw 

beqs 


d0,d7 

100$ 


| now 100$ has gone away again 
| generates an error message if no 100$ below 



v ) 



The labels first, second, and t h i r d all have a scope which is the entire 
source file containing them. The first appearance of the local label 100$ has a 
scope which extends between first and second. 

The second appearance of the local label 1 0 0 $ has a scope which extends 
between second and third. After the appearance of the label third, the 
branch to 1 0 0 $ will generate an error message because that label is no longer 
defined in this scope. 

2.6. Constants There are two forms of constants available to as users, namely numeric con- 

stants and string constants. All constants are considered absolute quantities 
when they appear in an expression (see Section 3.4 for a discussion on absolute 
and relocatable expressions). 

2.7. Numeric Constants as assumes that any token which starts with a digit is a numeric constant, as 

accepts numeric quantities in decimal (base 10), hexadecimal (base 16), and octal 
(base 8) radices, and floating-point quantities. Numeric constants can represent 
quantities up to 32 bits in length. 

Decimal numbers consist of between one and ten decimal digits (in the range 0 
through 9). The range of decimal numbers is between -2,147,483,648 and 
2,147,483,647. Note that you can’t have commas in decimal numbers even 
though they are shown here for readability. Note also that decimal numbers can’t 
be written with leading zeros, because a numeric constant starting with a zero is 
taken as either an octal constant or a hexadecimal constant, as described below. 

Hexadecimal constants start with the notation Ox or OX (zero-ex) and can then 
have between one and eight hexadecimal digits. The hexadecimal digits consist 
of the decimal digits 0 through 9 and the letters a through f or A through 
F. 

Octal constants start with the digit 0. There can then be from one to 1 1 octal 
digits (0 through 7) in the number. But note that 1 1 octal digits is 33 bits, so the 
largest octal number is 037777777777. 
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Floating-point constants must start with #Or or #OR, which may be followed by 
an optional sign and either a number, an infinity or a nan ("not a number"). The 
syntax is 















{ #0r | #0R} [ + 


-] {<number> | inf 


nan} 
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where the syntax of a <number> is 





{ <digits> [. [<digits>] ] | . <digits > } [E [+ | -] <digits > ] 

< > 



and <digits> is a sequence of decimal digits. 

2.8. String Constants A string is a sequence of ASCII characters, enclosed in quote signs ’ 

Within string constants, the quote sign is represented by a backslash character 
followed by a quote sign. The backslash character itself is represented by two 
backslash characters. Any other character can be represented by a backslash 
character followed by one, two, or three octal digits, or by a backslash followed 
by 0 x or OX and a one-, two-, or three-digit hexadecimal constant. The table 
below shows the octal representation of some of the more common non-printing 
characters. 



Character 


Octal 


Hex 


Backspace 


\010 


\0x8 


Horizontal Tab 


\011 


\0x9 


Newline (Linefeed) 


\0 12 


\0xA 


Formfeed 


\014 


\ OxC 


Carriage Return 


\015 


\ OxD 



2.9. Assembly Location The assembly location counter is the period character ( . ). It is colloquially 

Counter known as dot. When used in the operand field of any statement, dot represents 

the address of the first byte of the statement. Even in assembler directives, dot 
represents the address of the start of that assembler directive. For example, if dot 
appears as the third argument in a . long directive, the value placed at that loca- 
tion is the address of the first location of the directive — dot is not updated until 
the next machine instruction or assembler directive. For example: 



/ 






> 


Ralph : 


movl . , aO 


| load value of Ralph into aO 





You can reserve storage by advancing dot. For example, the statement 
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\ 


Table: 


.=.+0x100 




v 




) 



reserves 256 bytes (100 hexadecimal) of storage, with the address of the first byte 
as the value of Table. This is exactly equivalent to using . skip ( the preferred 
syntax) as follows: 



— 






'N 


Table : 

V 


. skip 


0x100 


-J 



The value of dot is always relative to the start of the current control section. For 
example, 



. = 0x1000 

l / 



doesn’t set dot to absolute location 0x1000, but to location 0x1000 relative to the 
start of the current control section. This practice is not recommended. 
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Expressions 



Expressions are combinations of operands (numeric constants and identifiers) and 
operators, forming new values. The sections below define the operators which 
as provides, then gives the rules for combining terms into expressions. 

3.1. Operators Identifiers and numeric constants can be combined, via arithmetic operators, to 

form expressions, a s provides unary operators and binary operators, as 
described below. 

Table 3-1 Unary Operators in Expressions 



Operator 


Function 


Description 


- 


unary minus 


Two’s complement of its argument. 


~ 


logical negation 


One’s complement of its argument. 



Table 3-2 Binary Operators in Expressions 



Operator 


Function 


Description 


+ 


addition 


Arithmetic addition of its arguments. 


- 


subtraction 


Arithmetic subtraction of its arguments. 


* 


multiplication 


Arithmetic multiplication of its arguments. 


/ 


division 


Arithmetic division of its arguments. Note that 
division in as is integer division, which trun- 
cates towards zero. 



Each operator works on 32-bit numbers. If the value of a particular term occu- 
pies only 8 bits or 16 bits, it is sign extended to a full 32-bit value. 
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3.2. Terms A term is a component of an expression. A term may be any of the following: 

□ A numeric constant, whose 32-bit value is used. The assembly location 
counter, known as dot, is considered a number in this context. 

□ An identifier. 

□ An expression or term enclosed in parentheses ( ) . 

Any quantity enclosed in parentheses is evaluated before the rest of the 
expression. This can be used to alter the normal left-to-right evaluation of 
expressions — for example, differentiating between a*b+c and a* (b+c ) 
or to apply a unary operator to an entire expression — for example, 

- (a*b+c) . 

□ A term preceded by a unary operator. For example, both 
double_plus_ungood and ~double_plus_ungood are terms. 

Multiple unary operators can be used in a term. For example, — positive 
has the same value as positive. 

3.3. Expressions Expressions are combinations of terms joined together by binary operators. An 

expression is always evaluated to a 32-bit value. 

If the operand requires only a single-byte value (a . byte directive or an addq 
instruction, for example) the low-order eight bits of the expression’s value are 
used. 

If the operand requires only a 16-bit value (a . word directive or a movem 
instruction, for example) the low-order 16 bits of the expression’s value are used. 



Expressions are evaluated left to right with no operator precedence. Thus 



— 




1 + 2*3 




V 


) 



evaluates to 9, not 7. Unary operators have precedence over binary operators 
since they are considered part of a term, and both terms of a binary operator must 
be evaluated before the binary operator can be applied. 

A missing expression or term is interpreted as having a value of zero. In this 
case, an Invalid expression error is generated. 

An Invalid Operator error means that a valid end-of-line character or binary 
operator was not detected after the assembler processed an expression. In partic- 
ular, this error is generated if an expression contains an identifier with an illegal 
character, or if an incorrect comment character was used. 

3.4. Absolute, Relocatable, When an expression is evaluated, its value is either absolute, relocatable, or 

external: 

An expression is absolute if its value is fixed. 

□ An expression whose terms are constants is absolute. 

□ An identifier whose value is a constant via a direct assignment statement is 
absolute. 



and External 
Expressions 
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□ A relocatable expression minus a relocatable term is absolute, if both items 
belong to the same program section. 

An expression is relocatable if its value is fixed relative to a base address, but 
will be adjusted by an offset value when it is linked or loaded into memory. All 
labels of a program defined in relocatable sections are relocatable terms. 

Expressions containing relocatable terms must only have constants added or sub- 
tracted to their values. For example, assuming the identifiers widget and 
blivet were defined in a relocatable section of the program, then the following 
demonstrates the use of relocatable expressions: 



Expression 


Description 


widget 


is a simple relocatable term. Its value is an offset from 
the base address of the current control section. 


widget+5 


is a simple relocatable expression. Since the value of 
widget is an offset from the base address of the current 
control section, adding a constant to it does not change 
its relocatable status. 


widget *2 


Not relocatable. Multiplying a relocatable term by a 
constant invalidates the relocatable status. 


2-widget 


Not relocatable, since the expression cannot be linked by 
adding widget’s offset to it. 


widget-blivet 


Absolute, since the offsets added to widget and 
blivet cancel each other out. 



An expression is external (or global) if it contains an external identifier not 
defined in the current program. With one exception, the same restrictions on 
expressions containing relocatable identifiers apply to expressions containing 
external identifiers. The exception is that the expression 



✓ 


\ 


widget-blivet 




v 


J 



is incorrect when both widget and blivet are external identifiers — you 
cannot subtract two external relocatable expressions. In addition, you cannot 
multiply or divide any relocatable expression. 
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Assembly Language Program Layout 



An as program consists of a series of statements. Several statements can be 
written on one line, but statements cannot cross line boundaries. The format of a 
statement is: 

r > 

[< label field. >] [ < opcode > [< operand field >] ] 

s ; 



It is possible to have a statement which consists of only a label field. 

The fields of a statement can be separated by spaces or tabs. There must be at 
least one space or tab separating the opcode field from the operand field, but 
spaces are unnecessary elsewhere. Spaces may appear in the operand field. 
Spaces and tabs are significant when they appear in a character string (for 
instance, as the operand of an .ascii pseudo-op) or in a character constant. In 
these cases, a space or tab stands for itself. 

A line is a sequence of zero or more statements, optionally followed by a com- 
ment, ending with a < newline> character. A line can be up to 4096 characters 
long. Multiple statements on a line are separated by semicolons. Blank lines are 
allowed. The form of a line is: 

. 

[< statement > [ ; < statement > ...]][ | < comment > ] 

< > 



Labels are identifiers which the programmer may use to tag the locations of pro- 
gram and data objects. The format of a < label field> is: 



f 




> 




< identifier >: [< identifier >:] . . . 




V 




> 



If present, a label always occurs first in a statement and must be followed by a 
colon: 



r 






sticky: 


| label defined here. 




V 




J 
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More than one label may appear in the same source statement, each one being 
terminated by a colon: 



r 






presson: grab: hold: 


I multiple labels defined here. 




\ 




J 



The collection of label definitions in a statement is called the label field. 

When a label is encountered in the program, the assembler assigns that label the 
value of the current location counter. The value of a label is relocatable. The 
symbol’s absolute value is assigned when the program is linked with the system 
linker ld(l). 

4.2. Operation Code Field The operation code (opcode) field of an assembly language statement identifies 

the statement as either a machine instruction or an assembler directive. 

One or more spaces (or tabs) must separate the operation code field from the fol- 
lowing operand field in a statement. Spaces or tabs are unnecessary between the 
label and operation code fields, but they are recommended to improve readability 
of the program. 

A machine instmction is indicated by an instruction mnemonic. The assembly 
language statement is intended to produce a single executable machine instruc- 
tion. The operation of each instmction is described in the Motorola user manuals 
for either the MC68020 or MC68030. Conventions used in as for instmction 
mnemonics are described in Chapter 6 and a complete list of the instructions is 
presented in Appendix B. 

An assembler directive, or pseudo-op, performs some function during the assem- 
bly process. It does not produce any executable code, but it may assign space for 
data in a program. 

Note that as expects that all instmction mnemonics in the op-code field are in 
lower case only. Using upper case letters in instmction mnemonics gives rise to 
an error message. 

The names of register operands must also be in lower case only. This behavior 
differs from the case for identifiers, where both upper and lower case letters may 
be used and are considered distinct. 

Many MC68010, MC68020 and MC68030 machine instructions can operate 
upon byte (8-bit), word (16-bit), or long word (32-bit) data. The size that the 
programmer requires is indicated as part of the instmction mnemonic. For 
instance, a movb instmction moves a byte of data, a movw instmction moves a 
16-bit word of data, and a movl instmction moves a 32-bit long word of data. 

In general, the default size for data manipulation instructions is word. 

Many MC6888 1 or MC68882 machine instmctions can operate on byte, word or 
long word integer data, on single-precision (32-bit), double-precision (64-bit) or 
extended-precision (96-bit) floating-point data or on packed-decimal (96-bit) 
data. The size required is specified as part of the instmction mnemonic by a trail- 
ing "b", "w", "1", "s", "d", "x" or " p", respectively. 
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An alternate coprocessor id can be specified for MC6888 1 instructions by 
appending @id to the opcode, such as f add02. If you don’t do this, the copro- 
cessor id specified by the most recent . cpid pseudo-operation is used. (See 
Chapter 5.) 

Similarly, branch instructions can use a long or short offset specifier to indicate 
the destination. So the beq instruction uses a 16-bit offset, whereas the beqs 
uses a short (8 -bit) offset. 

Note that this implementation of as provides an extended set of branch instruc- 
tions which start with the letter j instead of b. If the programmer uses the j 
forms, the assembler computes the offset size for the instruction. See Section 1.1 
for the assembler options which control this. 

4.3. Operand Field The operand, field of an assembly language statement supplies the arguments to 

the machine instruction or assembler directive. 

as makes a distinction between the < operand field> and individual < operands > 
in a machine instmction or assembler directive. Some machine instructions and 
assembler directives require two or more arguments, and each of these is referred 
to as an “operand”. 



In general, an operand field consists of zero or more operands, and in all cases, 
operands are separated by commas. In other words, the format of an <operand 
field> is: 



— 






a 




[<operand> [,<operand>] . 


. • ] 




< 






> 



The general format of the operand field for machine instructions is the same for 
all instructions, and is described in Chapter 6. The format of the operand field 
for assembler directives depends on the directive itself, and is included in the 
directive’s description in Chapter 5 of this manual. 

Depending upon the machine instmction or assembler directive, the operand field 
consists of one or more operands. The kinds of objects which can form an 
operand are: 

□ Registers 

□ Register pairs 

□ Addresses 

□ String constants 

o Floating-point constants 

□ Register lists 

□ Expressions 

Register operands in a machine instmction refer to the machine registers of the 
processor or coprocessor. 
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Note that register names must be in lower case; as does not recognize register 
names in upper case or a combination of upper case and lower case. 

Expressions are described in Chapter 3, address operands in Section 6.3, and con- 
stants in Chapter 2. 

4.4. Comment Field as provides a means for the programmer to place comments in the source code. 

There are two ways of representing comments. 



A line whose first non-whitespace character is the hash character ( #) is con- 
sidered a comment. This feature is handy for passing C preprocessor output 
through the assembler. For example, these lines are comments: 



f 




a 


# 


This is a comment line. 

# And this one is also a comment line. 




L _ 




J 



The other way to introduce a comment is when a comment field appears on a line 
with a statement. The comment field is indicated by the presence of the vertical 
bar character ( | ) after the source statement. 

The comment field consists of all characters on a source line including and fol- 
lowing the comment character. The assembler ignores the comment field. Any 
character may appear in the comment field, with the obvious exception of the 
< newline > character, which starts a new line. 



An assembly language source line can consist of just a comment field. For exam- 
ple, the two statements below are quite acceptable to the assembler: 







| This is a comment field. 




| So is this. 




v 


J 



4.5. Direct Assignment 
Statements 



A direct assignment statement assigns the value of an arbitrary expression to a 
specified identifier. The format of a direct assignment statement is: 



< identifier > = 
v 


<expression> 


j 


Examples of direct assignments are: 


vect_size 

vectora 

vectorb 

CRLF 


= 4 

= OxFFFE 

= vectora-vect_size 
= OxODOA 




dtemp 

v 


= dO | use register dO 


as temporary 



Any identifier defined by direct assignment may be redefined later in the pro- 
gram, in which case its value is the result of the last previous such statement. 
This is analogous to the SET operation found in other assemblers. 
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A local identifier may be defined by direct assignment, though this doesn’t make 
much sense. 

Register identifiers may not be redefined. 

An identifier which has already been used as a label may not be redefined, since 
this would be tantamount to redefining the address of a place in the program. In 
addition, an identifier which has been defined in a direct assignment statement 
cannot later be used as a label. Both situations give rise to assembler error mes- 
sages. 

If the <expression> in a direct assignment is absolute, the identifier is also abso- 
lute, and may be treated as a constant in subsequent expressions. If the < expres- 
sion is relocatable, however, the < identifier > is also relocatable, and it is con- 
sidered to be declared in the same program section as the expression. 



If the < expression > contains an external identifier, the identifier defined by direct 
assignment is also considered external. For example: 



— 




\ 


. globl X 


I X is declared as external identifier 




holder = X 


| holder becomes an external identifier 




V 




) 



assigns the value of X (zero if it is undefined) to holder and makes holder an 
external identifier. External identifiers may be defined by direct assignment. 

4.6. Self-Modifying Code If you intend to write programs that must modify their own code, you must be 

able to flush the processor’s cache to make sure that the code the program has 
just modified is not overwritten by a cache fill. 

Flushing the cache is done by using a special trap to request SunOS to do the 
operation; trap #2. (Note that this is not system call #2, which is trap #0 with the 
value 2 in register dO.) Here are some sample definitions and usage relating to 
cache flushing: 
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f 










— 


. long 


syscall 


I 0x20 


Trap instruction 0 (system call) 




. long 


badtrap 


I 0x21 


Trap instruction 1 (monitor breakpoint) 




. long 


flush 


1 0x22 


Trap instruction 2 (cache flush) 






.globl flush 










flush : 












movl # I CACHE 


CLEAR+ ICACHE ENABLE+DCACHE_CLEAR+DCACHE ENABLE, dO 




move d0,cacr 






| clear (and enable) the cache 






rte 










#def ine 


ICACHE_BURST 




0x0010 






#def ine 


ICACHE ENABLE 




0x0001 


+ ICACHE BURST 




#def ine 


ICACHE_FREEZE 




0x0002 






#def ine 


ICACHE_CLRENTRY 




0x0004 






#def ine 


ICACHE_CLEAR 




0x0008 






♦define 


DCACHE_BURS T 




0x1000 






♦define 


DCACHE ENABLE 




0x2100 


+ DCACHE BURST 




♦define 


DCACHE FREEZE 




0x0200 






♦define 


DCACHE__CLRENTRY 




0x0400 






♦define 


DCACHE_CLEAR 




0x0800 






v 










J 



You call the trap from a program with 



( 






... .. 


trap 

v 


♦2 


I cause trap #2, which calls .flush 


> 



Please note that this sort of operation could have dire consequences if not prop- 
erly used. 
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Assembler Directives 



Assembler directives are also known as pseudo operations or pseudo-ops. 
Pseudo-ops are used to direct the actions of the assembler, and to achieve effects 
such as generating data. The pseudo-ops available in as are listed in Table 5-1 
below. 

Table 5-1 Assembler Directives 



Pseudo- 

Operation 


Description 


. ascii 


Generates a sequence of ASCII characters. 


. asciz 


Generates a sequence of ASCII characters, terminated by a zero byte. 


.byte 


Generates a sequence of bytes in data storage. 


.bytez 


Generates a sequence of bytes in data storage initialized to zero. 


. word 


Generates a sequence of words in data storage. 


. long 


Generates a sequence of long words in data storage. 


. single 


Generates a sequence of single-precision floating-point constants in 
data storage. 


. double 


Generates a sequence of double-precision floating-point constants in 
data storage. 


. text 


Specifies that the following generated code be placed in the text control 
section until further notice. 


. data 


Specifies that the following generated code be placed in the data con- 
trol section until further notice. 


. datal 


Specifies that the following generated code be placed in the datal con- 
trol section until further notice. 


. data2 


Specifies that the following generated code be placed in the data2 con- 
trol section until further notice. 


.bss 


Specifies that space will be reserved in the bss control section until 
further notice. 


. globl 


Declares an identifier as global (external). 


. comm 


Declares the name and size of a common area. 



fsun 
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Table 5-1 Assembler Directives — Continued 



Pseudo- 

Operation 


Description 


. lcomm 


Reserves a specified amount of space in the bss control section. 


. skip 


Advances the current location counter by a specified amount. 


. align 


Forces current location counter to next one-, two-, four- or eight-byte 
boundary. 


. even 


Forces current location counter to next word (even-byte) boundary. 


. stab* 


Builds special symbol table entries. These directives are included for 
the benefit of compilers which generate information for the symbolic 
debuggers dbx and dbxtool. 


.proc 


Separates procedures for faster span-dependent instruction resolution. 


. cpid 


Assigns a coprocessor number. 



These assembler directives are discussed in detail in the following sections. 



5.1. .ascii — Generate The .ascii directive translates character strings into their ASCII equivalents 

Character Data for use in the program. The format of the .ascii directive is: 





[ <label> : ] .ascii " <character string> " 

^ > 



< character string> contains any character or escape sequence which can appear 
in a character string. Obviously, a newline must not appear within the character 
string. A newline can be represented by the escape sequence \012. The following 
examples illustrate the use of the .ascii directive: 



Octal Code Generated: 



Statement: 



150 


145 


154 


154 


157 


040 


. ascii 


"hello there" 


164 


150 


145 


162 


145 








127 


141 


162 


156 


151 


156 


. ascii 


"Warning-\007\007 


147 


055 


007 


007 


040 


012 






141 


142 


143 


144 


145 


146 


. ascii 


"abcdefg" 


147 
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5.2. .asciz — Generate 
Zero-T erminated 
Sequence of Character 
Data 



The .asciz directive is equivalent to the .ascii directive except that a zero 
byte is automatically appended as the final character of the string. This feature is 
intended for generating strings which C programs can use. The following exam- 
ples illustrate the use of the .asciz directive: 



/ 



















Octal Code Generated: 




Statement: 




110 


145 


154 


154 


157 


040 


.asciz "Hello World!" 




127 


157 


162 


144 


041 


000 






124 


150 


105 


040 


107 


162 


.asciz "The Great PROMpkin strikes again!" 




145 


141 


164 


040 


120 


122 






117 


115 


160 


153 


151 


156 






040 


163 


164 


162 


151 


153 






145 


163 


040 


141 


147 


141 






151 


156 


041 


000 
























j 



5.3. Directives to Generate The .byte, .word., .long, . single, and .double directives reserve 
Data storage locations and initialize them with specified values. 

The format of the various forms of data generation statements are: 




[ < label > : ] 


.byte 


[ <expression> ] 


[, 


<expression> ] 


[ < label > : ] 


.bytez 


<number> 






[ < label > : ] 


.word 


[ <expression> ] 


[, 


<expression> ] 


[ <label> : ] 


. long 


[ <expression> ] 


[, 


<expression> ] 


[ <label> : ] 


.single 


[ <expression> ] 


[, 


<expression> ] 


[ <label> : ] 


. double 


[ <expression> ] 


[, 


<expression> ] 



v J 



The . byte directive reserves one byte (8 bits) for each expression in the 
operand field, and initializes it to the low-order 8 bits of the corresponding 
expression’s value. 

The .bytez directive reserves < number > bytes (8 bits), and initializes them to 
zero. 

The . word directive reserves one word (16 bits) for each expression’s value in 
the operand field, and initializes it to the low-order 16 bits of the corresponding 
expression’s value. 

The . long directive reserves one long word (32 bits) for each expression in the 
operand field, and initializes it to the value of the corresponding expression’s 
value. 
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The . single directive reserves one long word for each expression in the 
operand field, and initializes it to the low-order 32 bits of the corresponding 
expression’s value. 

The . double directive reserves a pair of long words for each expression in the 
operand field, and initializes them to the value of the corresponding expression’s 
value. 

Multiple expressions can appear in the operand field of the . byte, . word, 

. long, . single, and . double directives. Multiple expressions must be 
separated by commas. 

5.4. Directives to Switch These statements .text, .data, .bss, .datal,and . data 2, change the 

Location Counter ‘control section’ where assembled code is loaded. 

as (and the system linker) view programs as divided into three distinct sections 
or address spaces: 



Space 


Description 


text 


The address space where the executable machine instructions are 
placed. 


data 


The address space where initialized data is placed. The assem- 
bler actually knows about three data sections, namely, data, 
datal , and data.2. The second and third data areas are mainly for 
the benefit of compilers and are of minimal interest to the assem- 
bly language programmer. 

If the -R option is coded on the as command line, it means that 
the initialized data should be considered read-only. It is actually 
placed at the end of the text area. 


bss 


The address space where the uninitialized data areas are placed. 
Also, see the . lcomm directive described below. 



For historical reasons, the different areas are frequently referred to as ‘control 
sections’ (csects for short). 

These sections are equivalent as far as as is concerned, with the exception that 
no instmctions or data are generated for the bss section — only its size is com- 
puted and its symbol values are output. 

During the first pass of the assembly, as maintains a separate location counter 
for each section. Consider the following code fragments: 
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c 


.text 




\ 

I place next instruction 


code : 


movw 


dl,d2 


| in text section 




. data 




| now generate data in 


grab: 


. long 


27 


| data section 




.text 




| now revert to text 


more : 


addw 


d2 , dl 


I section 




. data 




I now back to data section 


hold: 


.byte 


4 


-j 



During the first pass, as creates the intermediate output in two separate chunks: 
one for the text section and one for the data section. In the text section, code 
immediately precedes more; in the data section, grab immediately precedes 
hold. At the end of the first pass, as rearranges all the addresses so that the 
sections are sent to the output file in the order: text, data and bss. 

The resulting output file is an executable image file with all addresses correctly 
resolved, with the exception of undefined . globl’s and . comm’s. 

For more information on the format of the assembler’s output file, consult the 
a.out(5) entry in the System Programmer’ s Reference Manual. 

5.5. . skip — Advance the 
Location Counter 



where <size> is the number of bytes by which the location counter should be 
advanced. The .skip directive is equivalent to performing direct assignment 
on the location counter. For instance, a .skip directive like this: 




reserves 1000 bytes of storage, with the value of Table equal to the address of 
the first byte. 



5.6. . 1 comm — Reserve The . lcomm directive is a compact way to get a specific amount of space 

Space in bss Area reserved in the bss area. The format of the . lcomm directive is: 




where <name> is the name of the area to reserve, and <size> is the number of 
bytes to reserve. The . lcomm directive specifically reserves the space in the bss 
area, regardless of which location counter is currently in effect. 

A . lcomm directive like this: 
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a specified amount. The format of the . skip directive is: 
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is equivalent to these directives: 




5.7. . gl obi — Designate A program may be assembled in separate modules, and then linked together to 

an External Identifier form a single executable unit. See the ld( 1) command in the SunOS Reference 

Manual. 

External identifiers are defined in each of these separate modules. An identifier 
which is defined (given a value) in one module may be referenced in another 
module by declaring it external in both modules. 

There are two forms of external identifiers, namely, those declared with the 
. globl directive and those declared with the . comm directive. The . comm 
directive is described in the next section. 



External symbols are declared with the . globl assembler directive. The format 
is: 




For example, the following statements declare the array TABLE and the routine 
SRCH as external symbols, and then define them as locations in the current con- 
trol section: 



r 


. globl 


TABLE, SRCH 


TABLE : 


. word 


o 

o 

o 

o 

o 


SRCH: 


movw 


TABLE, dO 


< 


etc . 


j 



5.8. . comm — Define Name The . comm directive declares the name and size of a common area, for compati- 

and Size of a Common bility with FORTRAN and other languages which use common. The format of the 

Area . comm statement is: 




where <name> is the name of the common area, and < constant expression> is 
the size of the common area. The . comm directive implicitly declares the 
identifier <name> as an external identifier. 



as does not allocate storage for common symbols; this task is left to the linker. 
The linker computes the maximum declared size of each common symbol (which 
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5.9. .align — Force 
Location Counter to 
Particular Byte 
Boundary 



may appear in several load modules), allocates storage for it in the final bss sec- 
tion, and resolves linkages. If, however, <name> appears as a global symbol 
(label) in any module of the program, all references to <name> are linked to it, 
and no additional space is allocated in the bss area. 



The .align directive advances the location counter to the next one-, two-, four- 
or eight-byte boundary, if it is not currently on such a boundary. Intervening 
bytes are filled with zeros. The format of the .align directive is: 



r 




.align <size> 




v 


) 



where <size> must be an assembler expression which evaluates to 1 ,2,4 or 8. 

If you choose to use the . align 4 or align 8 directives, you must use the - 
J flag when you assemble your program; the assembler does span-dependent 
instruction resolution, and using align 4 or align 8 changes the address of 
jump targets. 

This directive is necessary because 

□ Word and long word data values must lie on even-byte boundaries 

□ Machine instructions must start on even-byte boundaries 

a The MC68020 and MC68030 operate much more efficiently if word and 
long word data are on even-byte and four-byte boundaries, respectively. 



5.10. . even — Force 
Location Counter to 
Even Byte Boundary 



The .even directive advances the location counter to the next even-byte boun- 
dary, if its current value is odd. This directive is provided because word and long 
word data values must lie on even-byte boundaries, and also because machine 
instructions must start on even-byte boundaries. . even is equivalent to 
. align 2. 



r~ 








. even 




L_ 




J 



5.11. . st abx — Build 

Special Symbol Table 
Entry 



The . st abx directives are provided for the use of compilers which can generate 
information for the symbolic debuggers dbx and dbxtool. The directives 
. stabs, . stabd, and . stabn build various types of symbol table entries. 

The . st abx directives have the following forms: 





. stabs 


name , type , 0 , desc , value 


> 




. stabn 


type , 0 , desc , value 




l 






J 


or 
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f 







. stabd 


type , 0 , desc 




v 




J 



L .stabs directives are used to describe types, variables, procedures, and so on, 
while . stabn directives convey information about scopes and the mapping 
from source statements to object code. 

A . stabd directive is identical in meaning to a corresponding . stabn direc- 
tive with the value field set to (dot), which the assembler uses to mean the 
current location. Most of the needed information, for example symbol name and 
type structure, is contained in the name field. The type field identifies the type of 
symbolic information, for example source file, global symbol, or source line. 

The desc field specifies the number of bytes occupied by a variable or type or the 
nesting level for a scope symbol. The value field specifies an address or an 
offset. 

The -R flag conflicts with the . stabx directive because there is no appropriate 
data type being set up for static variables. 



5.12. . proc — Separate 
Procedures for Span- 
Dependent 
Instruction 
Resolution 



The .proc directive separates procedures for span-dependent instruction resolu- 
tion. In its absence the assembler does span-dependent instruction resolution 
over entire files. If . proc is used, the resolution is done between occurrences of 
the directive and between either end of the file and its nearest occurrences. Since 
the algorithm used requires more than linear time, using .proc can save 
significant time for large assemblies. Branch instructions must not cross . proc 
directives, although calls may. 



r 


N 


• proc 




V 


J 



5.13. .cpid — Name 

Default Coprocessor 
ID 



The . cpid directive gives the assembler a coprocessor id value to use for 
MC6888 1 instructions that don’t have an explicit coprocessor id given. The 
form of the directive is 



— 


>1 


. cpid <id> 






V 



If no . cpid directive is given in a program, a value of 1 is assumed. Since no 
Sun system currently has more than one coprocessor, you don’t need to use this 
directive. 
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Instructions and Addressing Modes 



This chapter describes the conventions used in as to specify instruction 
mnemonics and addressing modes. The information in this chapter is specific to 
the machine instructions and addressing modes of the MC68010, MC68020, and 
MC68030 microprocessors and the MC6888 1 and MC68882 coprocessors. See 
Appendix C for information on the Sun FPA and FPA+’s instruction sets and 
addressing modes. 

6.1. Instruction Mnemonics The instruction mnemonics that as uses are based on the mnemonics described 

in the relevant Motorola processor manuals. However, as deviates from them in 
several areas. 

Most of the MC68010, MC68020 and MC68030 instructions can apply to byte, 
word or long operands. Instead of using a qualifier of . b, . w, or . 1 to indicate 
byte, word, or long as in the Motorola assembler, as appends a suffix to the nor- 
mal instruction mnemonic, thereby creating a separate mnemonic to indicate 
which length operand was intended. 

For example, there are three mnemonics for the or instruction: orb, orw, and 
or 1 , meaning or byte, or word, and or long, respectively. 

Instruction mnemonics for instmctions with unusual opcodes may have addi- 
tional suffixes. Thus in addition to the normal add variations, there also exist 
addqb, addqw and addql for the add quick instruction. 

Branch instructions come in two flavors for the MC68010, byte (or short) and 
word, and an additional flavor, long, for the MC68020. Append the suffix s to 
the word mnemonic to specify the short version of the instruction. For example, 
beq refers to the word version of the Branch if Equal instruction, beqs refers to 
the short version, and beql refers to the long version. 



6.2. Extended Branch as supports extended branch instructions in addition to the instructions which 

Instruction Mnemonics explicitly specify the instruction length. These instruction’s names are, in most 

cases, constructed from the word versions by replacing the b with j . For 
example, compare beq with jeq. 

as’s rules for handling branch instructions are as follows: 

□ as automatically generates the corresponding short branch instruction if the 
operand of the extended branch instruction is a simple address in the text 
segment, and the offset to that address is sufficiently small. 
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□ as generates the corresponding branch instruction if the offset is too large 
for a short branch, but small enough for a branch. 

□ as implements an extended branch instruction when the operand either 
references an external address or is complex (see below) as follows: 

1. By a jmp or jsr (for jra or jbsr). 

2. If the target processor is the MC680 10, by a conditional branch (with 
the sense of the condition inverted) around a jmp for the extended con- 
ditional branches. 

3. If the target processor is the MC68020, by using the corresponding long 
branch. 

The extended mnemonics should only be used in the text segment — if they are 
used in the data segment, the most general form of the branch is generated. 

In this context, a complex address is either an address which specifies other than 
normal mode addressing, or a relocatable expression containing more than one 
relocatable symbol. For instance, if a, b and c are symbols in the current seg- 
ment, the expression a+b-c is relocatable, but not simple. 

Consult Appendix B for a complete list of the instruction opcodes. 

6.3. Addressing Modes Table 6-1 below describes the addressing modes that as recognizes. Note that 

certain modes are not valid for the MC68010. The notations used in this table 
have these meanings: 



Notation 


Meaning 


an 


An address register. 


6. n 


A data register. 


r i 


Either a data register or an address register. 


f i 


A floating-point register. 


d 


A displacement, which is a constant expression in as. In 
MC68020 or MC68030 mode, a length specifier ( : L, described 
below) may be appended to the displacement. Any forward or 
external references require the length specifier to be : 1. All 
other references permit either : 1 or : w or nulls. 


L 


The index register’s length. This may be either long (1) or word 
(w) or null. If the only value permitted by a particular addressing 
mode or category is 1 or w, then that letter appears in the table. 


s 


A scale factor that may be used to multiply the index register’s 
length. The scale factor may have a value of 1, 2, 4, or 8. 



The notation of two or three items separated by colons, such as r * : L : s, indi- 
cate items that may be optional. In that particular case, you may not specify : s 
unless you have specified :L, which you may not specify unless you have 
specified r i. The items in the list must appear in the order given in the tables 
that follow. 
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In the table where both d and d’ are specified, d corresponds to an MC68020 or 
MC68030 outer displacement and d’ corresponds to an MC68020 or MC68030 
base displacement. 

xxx refers to a constant expression. 

Certain instructions, particularly move, accept a variety of special registers 
including: 



Name 


Register 


sp 


stack pointer, which is equivalent to a 7 


sr 


status register 


cc 


condition codes of the status register 


usp 


user stack pointer 


pc 


program counter 


sf c 


source function code register 


df c 


destination function code register 


fpcr 


floating-point control register 


fpsr 


floating-point status register 


fpiar 


floating-point instruction address register 



The memory-indirect and program-counter memory-indirect addressing modes 
listed in the following tables are useable only with the MC68020 and MC68030. 

In each of these addressing modes, up to four user-specified values are used to 
generate the final operand address: 

□ base register 

□ base displacement 

□ index register 

□ outer dispacement 

All four user-specified values are optional. Both base and outer displacements 
may be null, word or long. When a displacement is null, or an element is 
suppressed, its value is taken as zero in the effective address calculation. 

In the case of memory-indirect addressing, an address register ( an) is used as a 
base register, and its value can be adjusted by an optional base displacement (d’). 
An index register (r 0 specifies an index operand (r i: L : s) and finally, an outer 
displacement ( d ) can be added to the address operand, yielding the effective 
address. 

Program-counter memory-indirect mode is exactly the same. The only difference 
is that the program counter is used as the base register. 

Some examples of these addressing modes follow: 
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a «@ ( d' :L, r i:L:s) 0 (d:L) 
a n@ ( d:L)Q(d ' :L,ri:L:s) 
a/i@0 

an0 (d: L) 0 

an0 (d' : L, ri: L : s) 0 

pc00 

/?C0 (d:L) 0 

/?c0 ( d' :L, rz:L:s) 0 (d:L) 
/7C0 (d: L) 0 (fif' : L, rz:L:s) 
0(rf:L)0 

0 {d' : L r rz : L : s ) 0 (z/:L) 

0 (d: L) 0 :L,rz:L:s) 

0 ( d ' : L, r/:L: s) 0 



In the table below, note that the notation ri/rj means ri and rj, while rijrj means ri 
through rj. 



Table 6-1 Addressing Modes 



Mode 



Notation 



Example 



Register 

Register Deferred 
Register List 



FPA register 
Floating-Point Register 
(MC6888 1 only) 



Postincrement 

Predecrement 



Displacement 
Word Index 
Long Index 



Absolute Short 
Absolute Long 



PC Displacement 
PC Word Index 
PC Long Index 
PC-Memory Indirect 
Pre-Indexed (68020) 
PC-Memory Indirect 
Post-Indexed (68020) 



Memory Indirect 
Pre-Indexed (68020) 
Memory Indirect 
Post-Indexed (68020) 



an, dn, sp, pc, cc,sr,usp 
an0 

ri rj or ri/rj 




an0 (d) 
a n0 (d, ri:w) 
a n0 (d, ri: 1) 




pc0 (d) 
pc0 (d, ri: w) 
pc0 (d, r/ : 1 ) 

pc0 (d' : L, ri : L : s) 0 (d: L) 
pc0 (d: L) 0 (d' : L, ri: L: s) 



an0 (d’ :L, r/:L: s) 0 (d:L) 
an0 (d: L) 0 (d f :L, r/:L: s) 



movw a3 , d2 
movw a30,d2 
movem a0-a4, a60- 



fpmoves fpal,d2 
fmoves fpl,a30(24) 



movw a30+,d2 
movw a30-,d2 



movw a30 (24),d2 
movw a30(16, d2:w),d3 
movw a30(16, d2:l),d3 



movw 1 4 : w , d2 
movw 1 4 : 1 , d2 



movw pc0(2O),d3 

movw pc0(14, d2:w),d3 

movw pc0(14, d2:l),d3 

movl pc0 (2 :w, d4 :w: 4) 0 (14 : 1) , d3 

movl pc0 (d: 1) 0 (3 : w, d2 : 1 : 4 ) , d3 



movl al0 (d:L, d2 : 1 : 4) 0 (14 : w) 
movl a20 (2 :w) 0 (14 :w, d4 : w: 2) 
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Table 6-1 Addressing Modes — Continued 



Mode 


Notation 


Example 


Normal 


identifier 


movw widget , d3 


Immediate 


%xxx 


movw #27+3, d3 



Normal mode assembles as PC-relative if the assembler can determine that this is 
appropriate, otherwise it assembles as either absolute short or absolute long, 
under control of the -d2 command line option. 

The Motorola manuals present different mnemonics (and in fact different forms 
of the actual machine instructions) for instmctions that use the literal effective 
address as data instead of using the contents of the effective address. For 
instance, they use the mnemonic adda for add address, as does not make 
these distinctions because it can determine the type of opcode required from the 
form of the operand. Thus an instruction of the form: 



— 

avenue: .word 0 




addl #avenue,aO 






j 


assembles to the add address instruction because 
address register. 


as can determine that a 0 is an 


r 

right now: = 40000 


A 


addl #right_now, dO 







J 



assembles to an add immediate instruction because as can determine that 
right _now is a constant. 

Because of this determination of operand forms, some of the mnemonics listed in 
the Motorola manuals are missing from the set of mnemonics that as recognizes. 

Certain classes of instructions accept only subsets of the addressing modes 
above. For example, the add instruction does not accept a PC-relative address as 
a destination, and register lists may be used only with the movem and f mo vem 
instructions. 

as tries to check all these restrictions and generates the illegal operand error 
code for instructions that do not satisfy the address mode restrictions. 

6.4. Addressing Categories The processors group the effective address modes into categories derived ffom 

the manner in which they are used to address operands. Note the distinction 
between address modes and address categories. There are 14 addressing modes 
in the MC68010 and 18 in the MC68020 and MC68030, and they fall into one or 
more of four addressing categories. The addressing categories are defined here, 
followed by a table summarizing the grouping of the addressing modes into 
categories. Note that register lists can be used only in the movem and f movem 
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Meanin 



Data 


means that the addressing mode is used to refer to data operands. 


Memory 


means that the addressing mode can refer to memory operands. 
Examples include all the a-register indirect address modes and 
all the absolute address modes. 


Alterable 


means that the addressing mode refers to operands which are 
writeable (alterable). This category takes in every addressing 
mode except the PC-relative addressing modes and the immedi- 
ate address mode. 


Control 


means that the addressing mode refers to memory operands with 
no explicit size specification. 



Some addressing categories can be intersected to make more restrictive ones. 
For example, the Motorola MC68010 manual mentions the Data Alterable 
Addressing Mode to mean that the particular instruction can only use those 
modes which provide data addressing and are alterable as well. 



Table 6-2 Addressing Categories 



Addressing 


Assembler 


Data 


Memory 


Control 


Alterable 


MC68020 














and MC68030 


Mode 


Syntax 










Only 



Register Direct 


an, d n, sp, pc, 
cc, sr, usp 


X 


A-Register Indirect 


a/z@ 


X 


A-Register Indirect 
with Displacement 


a/i@ (d:L) 


X 


A-Register Indirect 
with Word Index 


a«@ (d:L, ri:w:s) 


X 


A-Register Indirect 
with Long Index 


a/i@ (d: L, ri: 1 : s) 


X 


A-Register Indirect 
with Post Increment 


a nQ + 


X 


A-Register Indirect 
with Pre Decrement 


a n@- 


X 


A-Register Indirect 
with Displacement 


a (d) 


X 


A-Register Indirect 
with Word Index 


a«6 (d, ri: w) 


X 
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Table 6-2 Addressing Categories — Continued 



Addressing 


Assembler 


Data 


Memory 


Control 


Alterable 


MC68020 














and MC68030 


Mode 


Syntax 










Only 



A-Register Indirect an@ ( d, ri : 1 ) 
with Long Index 



Memory-Indirect an@ ( d:L ) 0 ( d ' : L , ri : L : s ) 

Post-Indexed 



Memory-Indirect an@ (d' : L, ri : L : s ) @ (d: L) 

Pre-Indexed 



Absolute Short 



Absolute Long 



PC-relative 



PC-Indirect 
with Displacement 



PC-relative 
with Long Index 



xxx: w 



XXX l 1 



pc0 (d) 



pc@ (d: L) 



PC-relative with pc0 (d, ri : w) 

Word Index 



PC-Indirect with pc@ (d : L , ri : w : s ) 

Word Index 



pc@ (d, ri: 1) 



PC-Indirect with pc@ (d : L, ri : 1 : s ) 

Long Index 



PC-Memory Indirect pc0 (d : L) 0 (d' : L, ri : L : s ) 
Post-Indexed 



PC-Memory Indirect pc0 (d' : h, ri : L : s ) 0 (d : L) 
Pre-Indexed 



Immediate Data fnnn 



X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 
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a s Error Codes 



A.l. Usage Errors ^ ,, 

° Cannot open output file 

The specified output file cannot be created. Check that the permissions 
allow opening this file. 



Cannot open source file 

The assembler cannot open the specified source file. Check the spelling, that 
the pathname supplied is correct, and that you have read permission for the 
file. 



No input file 

One or more input files must be specified — as cannot accept the output of 
a pipe as its input. 



Too many file names given 

The assembler cannot cope with more than one source file. Break the job 
into smaller stages. 



Unknown option ‘x’ ignored 

as does not recognize the option x. Valid options are listed in Section 1. 1 of 
this manual. If you are using either cc or f 7 7 to assemble a . s file, you 
should specify any .as options that you want to use by using -Qopt ion 
as <option>. 



A.2. Assembler Error If as detects any errors during the assembly process, it prints out a message of 



Messages 


the form: 






as: error (<line_no>) : <error_code> 








/ 



Error messages are sent to standard error. Here is a list of as error codes, and 
their possible causes. 



Illegal .align 

The expression following a .align evaluates to some value other than 1, 2, 
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4 or 8. (If you are using .align 4, be sure to do the assembly with the - J 
flag set.) 



Invalid assignment 

An attempt was made to redefine a label with a direct assignment statement. 



Invalid Character 

An unexpected character was encountered in the program text. 



Invalid Constant 

An invalid digit was encountered in a number. For example, using an 8 or 9 
in an octal number. Also happens when an out-of-range constant operand is 
found in an instruction — for example: 



r — 






■\ 




addq 


#200, dO 






asll 


#12, dO 




V 






J 



Invalid opcode 

The assembler did not recognize an instruction mnemonic. Probably a 
misspelling. 



Invalid operand 

The operand used is not consistent with the instruction used — for example: 




is an invalid combination of instruction and operand. Check the instruction 
set descriptions for valid combinations of instructions and operands. 



Invalid Operator 

Check the operand field for a bad operator. The operators that as recog- 
nizes are plus ( + ), minus ( - ), negate or one’s complement ( " ), multiply 
( * ), and divide ( / ). 



Invalid register expression 

A register name was found where one should not appear — for example: 



r “ 




a 




addl #d0,_there 




l 




J 



Invalid Register List 

The register list in a movem or fmovem instruction is malformed. Note 
that the list must contain more than one register name: to express a list 
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containing just a single register, you must write its name twice separated by 
a slash, e.g. fpO/fpO. 

Invalid string 

An invalid string was encountered in an .ascii or .asciz directive. 

□ Make sure the string is enclosed in double quotes. 

□ Remember that you must use the sequence \" to represent a quote inside 
a string. 



Invalid symbol 

An operand that should be a symbol is not — for example: 



( 








. globl 3 








J 



because the constant 3 is not a symbol. 



Invalid Term 

The expression evaluator could not find a valid term: a symbol, constant or 
<expression>. An invalid prefix to a number or a bad symbol name in an 
operand generates this message. 



Line too long 

A statement was found which has more than 4096 characters before the new- 
line character. 



Missing close-paren ’ )’ 

An unmatched ‘(’ was found in an expression. 



Multiply defined symbol 

□ An identifier appears twice as a label. 

□ An attempt was made to redefine a label using a direct assignment state- 
ment. 

□ An attempt was made to use, as a label, an identifier which was previ- 
ously defined in a direct assignment statement. 



Multiply Defined Symbol ( Phase Error) 

This rarely occurring message indicates an inconsistency in the assembler. 
Report it to Sun Microsystems Customer Support if it occurs. 



N on-relocatable expression 

If an expression contains a relocatable symbol (a label, for instance), the 
only operations that can be applied to it are the addition of absolute 
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expressions or the subtraction of another relocatable symbol (which pro- 
duces an absolute result). 



Odd address 

The previous instruction or pseudo-op required an odd number of bytes and 
this instruction requires word alignment. This error can only follow an 
. ascii, an . asciz, a .byte, or a . skip pseudo-operation. 

NOTE Use a .even directive to ensure that the location counter is forced to an even 
byte boundary. 

Offset too large 

The instruction is a relative addressing instruction and the displacement 
between this instruction and the label specified is too large for the address 
field of the instruction. 



Out of strings space 

No more room is left in the assembler’s internal string table. Divide the pro- 
gram into smaller portions; assemble portions of the program separately, 
then bind them together using the linker. 



Register out of range 

In the FPA’s dot product, matrix move and transpose instructions, if the 
register specified does not fall within the required range, this error is 
reported. Note that for most instructions where one operand is an effective 
address, the register range is 0 to 15. If all operands are FPA registers, the 
register range is 0 to 3 1 . For constant RAM registers, the range is 0 to 51 1. 
This type of error will generally also cause the Invalid operand error to be 
reported. 

Stab storage exceeded 

No more room is left in the assembler’s symbol table for debugging infor- 
mation. Cut the program into smaller portions; assemble portions of the pro- 
gram separately, then bind them together using the linker. 



Symbol storage exceeded 

No more room is left in the assembler’s symbol table. Divide the program 
into smaller portions; assemble portions of the program separately, then bind 
them together using the linker. 



Symbol Too Long 

A local label reference longer than one digit was found. 



Undefined L-symbol 

This is a warning message. A symbol beginning with the letter ‘L’ was used 
but not defined. It is treated as an external symbol. Compiler-generated 
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labels usually start with the letter ‘L’ and should be defined in this assembly. 
The absence of such a definition usually indicates a compiler code genera- 
tion error. This message is also generated by the use of symbols such as n$ 
if n$ has not been defined. 

Unqualified forward reference 

The displacement field in an MC68020 based/indexed address mode con- 
tains an unqualified forward reference. Note that the displacement in a 
based/indexed address mode for the MC68020 instruction set can contain a 
forward or external reference only if the length specifier is present. The 
length specifier should be : 1 (long). This type of error will generally also 
cause Multiply defined symbol (Phase error). 



Undefined Symbol 

A label reference to an undefined local label was found. 



Wrong number of operands 

Check Appendix B for the correct number of operands for the current 
instruction. 




Revision A of 27 March, 1990 





42 Assembly Language Reference 




Revision A of 27 March, 1990 





List of as Opcodes 



This appendix is a list of the instruction mnemonics accepted by as, grouped 
alphabetically. The list is divided into two tables, the first covers the MC680x0 
processor’s instructions, the second covers the MC6888 1 and MC68882 
floating-point coprocessors’ instructions. For more information about floating- 
point programming, see the Floating-Point Programmer’ s Guide . 

Each entry describes the following things: 

□ The mnemonics for the instruction, 

□ The generic name of the instruction, 

□ The assembly language syntax and the variations on the instruction, 

□ Whether the instruction is specific to the MC68020, or has extended capabil- 
ities on the MC68020 compared to the MC68010. 

The syntax for as machine instructions differs somewhat from the instruction 
layouts and categories shown in the Motorola processor manuals. For example, 
as provides a single set of mnemonics for add (add binary), adda (add 
address), and addi (add immediate), differentiated only by the length of the 
operands. In general, as selects the appropriate instruction from the form of the 
operands. 

Here is a brief explanation of the notations used below. 

□ An instruction of the form addX in the assembly language syntax column 
means that the instruction is coded as addb, addw, addl, etc. 

□ An operand field of an means any A-register. 

□ An operand field of dn means any D-register. 

□ An operand field of rn means any A- or D-register. 

□ An operand field of f n means any floating-point register. 

□ An operand field of cn means any control register. 

□ An operand field of ea means an effective address designated by one of the 
permissible addressing modes. Consult the relevant Motorola processor 
manual for details of the allowed addressing modes for each instruction. 
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An operand field of reglist means a “register list” specifying a list of regis- 
ters to be moved to or from memory. A register list is denoted by a slash- 
separated list of registers or ranges of registers. A range of registers is 
specified by the starting and ending register of that range, separated by a 
hyphen. 

For example, a register range including registers DO, Dl, and A 4 could 
be specified as d0-dl/a4. 

□ An operand field of vector means an exception vector location. 

□ An operand field of Mata means an immediate operand. 

□ Other special registers such as cc (condition code register) and sr 
(status register) are specifically indicated where appropriate. 

The MC68020 and MC68030 provide a set of bit-field manipulating instruc- 
tions that don’t exist on the MC68010. Their notation includes a bit field 
specifier of the form { ojfset'.width }, where the offset denotes the beginning 
of the bit field in the word and the width is the number of bits in the field. 

Offset values are counted from the high-order bit, as 0, to the low-order bit, 
as 31. 

NOTE This ordering is the reverse of the convention used in the bchg, bclr, bset, 
and btst instructions. 

Offset and width may be either constants or data registers. For example: 

□ bf ins dO , a50 (4) { #0 : #9 } 

□ bfexta a5@ (4) {dO : #8 } , 61 

In the table that follows, MC68020 entries in the "Processor" column indicate 
instructions found in MC68020 or later processors. 



Table B- 1 List ofMC680x0 Instruction Codes 



Mnemonic 


Operation Name 




Syntax 


Processor 


abed 


add decimal with extend 


abed 


dy,6x 








abed 


ay@-,aY@- 




addb 


add binary 


addY 


ea, d n 




addw 




addY 


d n,ea 




addl 




addY 


ea,an (except addb) 








addY 


%data,ea 




addqb 


add quick 


addqY 


%data , ea 




addqw 










addql 










addxb 


add extended 


addxY 


dy, dY 




addxw 




addxY 


ay@-, aY@- 




addxl 










andb 


logical and 


andY 


ea, dn 






sun 

microsystems 



Revision A of 27 March, 1990 




















Appendix B — List of a s Opcodes 45 



T able B - 1 List of MC 680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 


andw 




andX 


d n, ea 




andl 




andX 


%data, d n 




aslb 


arithmetic shift left 


aslX 


dX, d;y 




aslw 




a slX 


%data, d y 




asll 




a slX 


ea 




asrb 


arithmetic shift right 


asrX 


dx, dy 




asrw 




asrX 


{(data, dy 




asrl 




asrX 


ea 




bcc 


branch conditionally 


bccX 


label 




bccl 








MC68020/ 030 


bees 










bchg 


test a bit and change 


bchg 


d n, ea 








bchg 


%data, ea 




bclr 


test a bit and clear 


bclr 


dn, ea 








bclr 


kdata , ea 




bkpt 


breakpoint 


bkpt 


\data 


MC68020/030 


bset 


test a bit and set 


bset 


d n, ea 








bset 


\data,ea 




btst 


test a bit 


btst 


dn, ea 








btst 


ftdata, ea 




bf chg 


test a bit field and change 


bf chg 


ea { offset : width } 


MC68020/030 


bfclr 


test a bit field and clear 


bfclr 


ea { offset : width } 


MC68020/030 


bf exts 


extract a bit field signed 


bfexts ea {offset: width) ,dn 


MC68020/ 030 


bf extu 


extract a bit field unsigned 


bf extu ea { offset : width } ,dn 


MC68020/ 030 


bfffo 


find first one in bit field 


bfffo 


ea { offset : width } ,dn 


MC6802 0/ 030 


bf ins 


insert a bit field 


bf ins 


d n,ea{ offset : width } 


MC68020/030 


bf set 


test a bit field and set 


bf set 


ea { offset : width } 


MC68020/ 030 


bftst 


test a bit field 


bftst 


ea {offset -.width) 


MC68020/ 030 


bes 


branch carry set 


bcsX 


ea 




bcsl 








MC6802 0/ 030 


boss 










beq 


branch on equal 


beqX 


ea 




beql 








MC68020/030 


beqs 










bge 


branch greater or equal 


bgeX 


ea 




bgel 








MC68020/ 030 
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Table B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


bges 


branch greater or equal 






mam 


branch greater than 


bgtX ea 










MC68020/030 


SBH 










branch higher 


bhiX ea 




j 






MC68020/030 










ble 


branch less than or equal 


bleX ea 




blel 






MC68020/ 030 


bles 








bis 


branch lower or same 


bl sX ea 




blsl 






MC68020/030 




branch less than 


bltX ea 




















hh 


branch minus 


bmiX ea 




















bne 


branch not equal 


bneX ea 




bnel 






MC68020/030 


bnes 










branch positive 


bplX ea 










MC68020/030 












branch always 


braX label 










MC68020/ 030 


E29H 








bsr 


subroutine branch 


bsrX label 




bsrl 






MC68020/030 


bsrs 








bvc 


branch overflow clear 


bvcX ea 




bvcl 






MC68020/030 


bvcs 








bvs 


branch overflow set 


bvsX ea 








bvsl 


MC68020/030 


bvss 








callm 


call module 


callm %data, ea 


MC68020/030 


cas2b 


compare & swap with operand 


cas2X del : dc2 , dal : d«2 , (rnl) : (m2) 


MC68020/030 


cas21 






MC68020/030 
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Mnemonic 



cas2w 




chk2b 

chk21 

chk2w 



cmpmb 

cmpmw 

cmpml 



Table B- 1 List ofMC680x0 Instruction Codes — Continued 



Operation Name Syntax 



compare & swap with operand 



compare & swap with operand 



check register against bounds 



check register against bounds 





clear an operand 



compare register against bounds cmp2X ea,rn 



compare memory 



arithmetic compare 



dbcc 


decrement & branch on carry clear 


dbcc d n, label 


dbcs 


" on carry set 


dbcs dn, label 


dbeq 


" on equal 


dbeq dn, label 


dbf 


" on false 


dbf dn, label 


dbge 


" on greater than or equal 


dbge dn, label 


dbgt 


" on greater than 


dbgt dn, label 


dbhi 


" on high 


dbhi dn, label 


dble 


" on less than or equal 


dble dn, label 


dbls 


" on low or same 


dbls dn, label 


dblt 


" on less than 


dblt dn, label 


dbmi 


" on minus 


dbmi dn, label 


dbne 


" on not equal 


dbne dn, label 


dbpl 


" on plus 


dbpl dn, label 


dbra 


" always (same as dbf) 


dbra dn, label 


dbt 


" on True 


dbt dn, label 


dbvc 


" on overflow clear 


dbvc dn, label 


dbvs 


" on overflow set 


dbvs dn, label 


divs 


signed divide 


divs ea,dn 


divsl 




divsX ea,dn 


divsll 




divsX ea,dq 
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Table B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 




signed divide 


divsX ea,dr:dq 


MC68020/030 


divu 


unsigned divide 


divu ea, dn 




divul 




divuX ea, dn 


MC68020/030 


divuw 




divuX ea,dn 


MC68020/030 






divuX ea,dq 


MC 6 8 02 0/030 






divuX ea,drzdq 


MC68020/ 030 


divull 




divull ea,dr:dq 


MC68020/030 


eorb 


logical exclusive or 


eorX d n,ea 




eorw 




eorX %data,ea 




eorl 




eorb #data,cc 
eorw %data,sr 




exg 


exchange registers 


exg rx, ry 




extbl 


sign extend 


extbl dn 


MC68020/030 


extw 




extX dn 




extl 








jmp 


jump 


jmp ea 




jsr 


jump to subroutine 


jsr ea 




jcc 


jump carry clear 


jcc ea 




jcs 


jump on carry 


jcs ea 




jeq 


jump on equal 


jeq ea 




jge 


jump greater or equal 


jge ea 




jgt 


jump greater than 


jgt ea 




jhi 


jump higher 


jhi ea 




jle 


jump less than or equal 


jle ea 




jls 


jump lower or same 


jls ea 




jit 


jump less than 


jit ea 




jmi 


jump minus 


jmi ea 




jne 


jump not equal 


jne ea 




jpl 


jump positive 


jpl ea 




jra 


jump always 


jra ea 




jbsr 


jump to subroutine 


jbsr ea 




jvc 


jump no overflow 


jvc ea 




jvs 


jump on overflow 


jvs ea 




lea 


load effective address 


lea ea,an 




link 


link and allocate 


link an, %disp 




linkl 




linkl an, %disp 


MC68020/ 030 


lslb 


logical shift left 


IslX dx,dy 




lslw 




lslX idata, dy 




lsll 




IslX ea 




lsrb 


logical shift right 


IsxX dx,dy 




lsrw 




lsxX # data, dy 





epsun 
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T able B - 1 List of MC680xO Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


lsrl 


logical shift right 


IsrX ea 




movb 


move data 


mo vX ea , ea 




movl 








movw 




movX %data, dn 




movw 


move from condition code register 


movw cc, ea 




movw 


move from status register 


movw sr ,ea 




move 


move to/from control register 


move r n, or 








move cr,rn 




moveml 


move multiple registers 


movemX #mask., ea 




movemw 




movemX ea, %mask 
movemX ea , r eg list 
movemX reglist, ea 




movepl 


move peripheral 


movepX dn, an@ (d) 




movepw 




movepX a n@ (d) , dn 




moveq 


move quick 


moveq idata, dn 




movsb 


move to/from address space 


movsX rn, ea 




movsw 




movsX ea, rn 




movsl 








mu Is 


signed multiply 


muls ea, dn 




mulslw 




mulsX ea,dl 


MC6802 0/03 0 


mulsll 




mulsX ea, dh: dl 


MC68020/030 


mulu 


unsigned multiply 


mulu ea, dn 




mulul 




muluX ea,dl 


MC68020/030 






muluX ea,dh:dl 


MC68020/030 


nbed 


negate decimal with extend 


nbed ea 




negb 


negate binary 


negX ea 




negw 








negl 








negxb 

negxw 

negxl 


negate binary with extend 


negxX ea 




nop 


no operation 


nop 




notb 


logical complement 


notX ea 




notw 








notl 








orb 


inclusive or 


orX ea, dn 




orw 




orX d n,ea 




orl 




or %dala,ea 

orb #data,cc 
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Table B - 1 List of MC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 




inclusive or 


orw 


%data,sr 




pack 


pack 


pack 


ar@-,ay@-, ttdata 


MC68020/ 030 






pack 


dr,dy, %data 


MC68020/030 


pea 


push effective address 


pea 


ea 




reset 


reset device 


reset 




rolb 


rotate left 


rolX 


dr, dy 




rolw 


rotate left 


rolX 


%data r dy 




roll 




rolX 


ea 




rorb 


rotate right 


rorX 


dr, dy 




rorw 




ror X 


%data, dy 




rorl 




rozX 


ea 




roxlb 


rotate left with extend 


roxlX dr, dy 




roxlw 




roxlX %data, d y 




roxll 




roxlX ea 




roxrb 


rotate right with extend 


roxrX dr, dy 




roxrw 




roxrX %data , dy 




roxrl 




roxrX' ea 






return and deallocate parameters 


rtd Mata 






return from exception 


rte 








return from module 


rtm r n 


MC68020/030 


rtr 


return and restore codes 


rtr 






rts 


return from subroutine 


rts 










rts 


#n 




sbcd 


subtract decimal with extend 


sbcd 


dy, dr 








sbcd 


ay@-,ar0- 




stop 


halt machine 


stop 


#rrr 




subb 


arithmetic subtract 


subX 


ea, d n 




subw 




subX 


d n,ea 








subX 


ea,an 




subl 




subX 


§data, ea 




St 


set all ones 


St 


ea 




sf 


set all zeros 


sf 


ea 




shi 


set high 


shi 


ea 




sis 


set lower or same 


sis 


ea 




see 


set carry clear 


see 


ea 




scs 


set carry set 


scs 


ea 




sne 


set not equal 


sne 


ea 




seq 


set equal 


seq 


ea 




SVC 


set no overflow 


SVC 


ea 




svs 


set on overflow 


svs 


ea 
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T able B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


spl 


set plus 


spl ea 




smi 


set minus 


smi ea 




sge 


set greater or equal 


sge ea 




sit 


set less than 


sit ea 




sgt 


set greater than 


sgt ea 




sle 


set less than or equal 


sle ea 




subqb 


subtract quick 


subqX #data,ea 




subqw 








subql 


subtract quick 






subxb 


subtract extended 


subxX dy,dx 




subxw 




subxX a;y@-,ajc@- 




subxl 








swap 


swap register halves 


swap d n 




tas 


test operand then set 


tas ea 




trap 


trap 


trap # vector 




trapcc 


trap on carry clear 


trapccX 


MC68020/030 


trapccl 




trapccX %data 


MC68020/030 


trapccw 






MC68020/030 


trapes 


trap on carry set 


trapes x 


MC68020/ 030 


trapcsl 




trapcsX idata 


MC68020/030 


trapesw 






MC68020/030 


trapeq 


trap on equal 


trapeqX 


MC68020/030 


trapeql 




trapeqX %data 


MC6802 0/ 030 


trapeqw 






MC68020/030 


trapf 


trap on never true 


trapfX 


MC68020/030 


trapfl 




trapfX %data 


MC68020/030 


trapfw 






MC68020/ 030 


trapge 


trap on greater or equal 


trapgeX 


MC68020/ 030 


trapgel 




trapgeX #data 


MC68020/030 


trapgew 






MC68020/030 


trapgt 


trap on greater 


trapgtX 


MC68020/ 030 


trapgtl 




trapgtX %data 


MC68020/030 


trapgt 









The following table describes the MC6888 1 instruction mnemonics supported by 
as. 

Each mnemonic indicates the data type that it operates on by the last character of 
the mnemonic: 

□ b indicates a byte format instruction 
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52 Assembly Language Reference 



□ w indicates a word format instruction 

□ 1 indicates a long format instruction 

□ s indicates a single-precision format instruction 

□ d indicates a double-precision format instruction 

□ x indicates an extended-precision format instruction 

□ p indicates a packed format instruction 

□ y indicates that any of 1, s, p, w, d, or b, is acceptable. 



Table B -2 MC6888 1 Instructions supported by as 



Mnemonic 


Operation Name 


Syntax 


fabsx 


absolute value 


fabsx ea, f n 


fabsl 




fabsx fm, f n 


fabss 




fabsy ea, f n 


fabsp 






fabsw 






fabsd 






fabsb 






facosx 


arc cosine 


facosx ea, f n 


facosl 




facosx fm,fn 


facoss 




facosy ea, f n 


facosp 






facosw 






facosd 






facosb 






faddx 


add 


faddx ea, f n 


faddl 




faddx fm, fn 


fadds 




faddy ea, fn 


faddp 






faddw 






faddd 






faddb 






fasinx 


arc sin 


fasinx ea, fn 


fasinl 




fasinx fm,fn 


fasins 




fasiny ea, fn 


fasinp 






fasinw 






f asind 






fasinb 






f atanx 


arc tangent 


fatanx ea,fn 


fatanl 




f atanx fm, fn 


fatans 




fat any ea, fn 


fatanp 






fatanw 
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Table B-2 


MC6888 1 Instructions supported by a s — Continued 




Mnemonic 


Operation Name 


Syntax 


fatand 
f atanb 


arc tangent 




fatanhx 


hyperbolic arc tangent 


fatanhx ea, f n 


fatanhl 




fatanhx f m, f n 


fatanhs 




fatanhy ea, f n 


fatanhp 

fatanhw 

fatanhd 

fatanhb 


hyperbolic arc tangent (contd.) 




fbcc 


branch conditionally 


fbcc label 


fbeq 

fbeql 


(equal) 




fbf 
fbf 1 


(false) 




fbgt 

fbgtl 


(greater than) 




fble 

fblel 


(less than or equal) 




fblt 

fbltl 


(less than) 




fbge 

fbgel 


(greater than or equal) 




fbgl 

fbgll 


(greater than or less) 




fbgle 

fbglel 


(greater less or equal) 




fbgt 


(greater than) 




fbne 

fbnel 


(not equal) 




fbneq 

fbneql 


(not (equal)) 




fbnge 

fbngel 


(not greater than or equal) 




fbngl 

fbngll 


(not greater than or less) 




fbngle 

fbnglel 


(not greater than, less or equal) 




fbngt 

fbngtl 


(not greater than) 




fbnle 

fbnlel 


(not less than or equal) 




fbnlt 

fbnltl 


(not less than) 




fbt 


(true) 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


fbtl 


(true) 




fbor 

fborl 


(ordered) 




fbocc 


branch ordered conditionally 


f bo cc label 


fboge 

fbogel 


(ordered greater or equal) 




fbogl 

fbogll 


(ordered greater or less) 




fbogt 

fbogtl 


(ordered greater than) 




fbole 

fbolel 


(ordered less or equal) 




fbolt 

fboltl 


(ordered less than) 




fbcc 


branch signalling conditionally 


fbs cc label 


fbseq 

fbseql 


(signalling equal) 




fbsf 

fbsfl 


(signalling false) 




fbsne 

fbsnel 


(signalling not equal) 




fbst 

fbstl 


(signalling true) 




fbucc 


branch unordered conditionally 


fbucc label 


fbueq 

fbueql 


(unordered equal) 




fbuge 

fbugel 


(unordered greater or equal) 




fbugt 

fbugtl 


(unordered greater than) 




fbule 

fbulel 


(unordered less or equal) 




fbult 

fbultl 


(unordered less than) 




fbun 

fbunl 


(unordered) 




fcmpx 


compare 


fcmpx ea, fn 



fcmpl f cmpx f m, f n 

fcmps f cmpy ea, In 

fcmpp 

fcmpw 

fcmpd 

fcmpb 
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Table B-2 


MC6888 1 Instructions supported by as — Continued 




Mnemonic 


Operation Name 


Syntax 


f cosx 


cosine 


f cosx ea, f n 


f cosl 




f cosx f m, f n 


fcoss 




fcos y ea,fn 


f cosp 






fcosw 






f cosd 






f cosb 






fcoshx 


hyperbolic cosine 


fcoshx ea,fn 


f coshl 




fcoshx f m, f n 


fcoshs 




f co shy ea,£n 


f coshp 






f coshw 


hyperbolic cosine (contd.) 




f coshd 






f coshb 






fdbcc 


decrement & branch on condition 


fdbcc d n, label 


fdbeq 


(equal) 




fdbne 


(not equal) 




fdbgt 


(greater than) 




fdbngt 


(not greater than) 




fdbge 


(greater or equal) 




fdbnge 


(not greater or equal) 




fdblt 


(less than) 




fdbnlt 


(not less than) 




fdble 


(less or equal) 




fdbnle 


(not less or equal) 




fdbgl 


(greater or less) 




fdbngl 


(not greater or less) 




fdbgle 


(greater, less or equal) 




fdbngle 


(not greater, less or equal) 




fdbogt 


(ordered greater than) 




fdbule 


(unordered less or equal) 




fdboge 


(unordered greater or equal) 




fdbult 


(unordered less than) 




fdbolt 


(ordered less than) 




fdbuge 


(unordered greater or equal) 




fdbole 


(ordered less or equal) 




fdbugt 


(unordered greater than) 




fdbogl 


(ordered greater or less) 




fdbueq 


(unordered equal) 




fdbor 


(ordered) 




fdbun 


(unordered) 




fdbf 


(false) 




fdbt 


(true) 




fdbsf 


(signalling false) 
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Table B-2 


MC6888 1 Instructions supported by a s — Continued 




Mnemonic 


Operation Name 


Syntax 


fdbst 


(signalling true) 




fdbseq 


(signalling equal) 




fdbsne 


(signalling not equal) 




fdivx 


divide 


fdivx ea, f n 


fdivl 




fdivx f m, f n 


fdivs 

fdivp 

fdivw 

fdivd 

fdivb 




fdivy ea,fn 


fetoxx 


e x 


fetoxx ea, fn 


fetoxl 




fetoxx f m, fn 


fetoxs 

fetoxp 

fetoxw 

fetoxd 

fetoxb 




fetoxy ea, fn 


fetoxmlx 


e x -1 


fetoxmlx ea, fn 


fetoxmll 




fetoxmlx f m, fn 


fetoxmls 

fetoxmlp 

fetoxmlw 

fetoxmld 

fetoxmlb 




fetoxmly ea,fn 


fgetexpx 


get exponent 


fgetexpx ea,fn 


fgetexpl 




fgetexpx fm, fn 


fgetexps 

fgetexpp 

fgetexpw 

fgetexpd 

fgetexpb 




f get exp y ea,fn 


fgetmanx 


get mantissa 


fgetmanx ea, fn 


fgetmanl 




fgetmanx fm, fn 


fgetmans 

fgetmanp 

fgetmanw 

fgetmand 

fgetmanb 




fgetmany ea, fn 


fintx 


integer part 


fintx ea, fn 


fintl 




fintx fm,fn 


fints 

fintp 




f inty ea, fn 


f intw 
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Table B-2 MC68881 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


f intd 
f intb 


integer part 




f intrx 


integer part, round toward 0 


f intrx ea, f n 


f intrzl 




f intrx fm,fn 


f intrzs 
f intrzp 
f intrzw 
f intrzd 
f intrzb 




fintry ea, fn 


f jcc 


jump on condition 


£ jcc label 


f jeq 


(equal) 




f jne 


(not equal) 




f jneq 


(not equal or equal) 




f jgt 


(greater than) 




f jngt 


(not greater than) 




f jge 


(greater or equal) 




f jnge 


(not greater or equal) 




f jit 


(less than) 




f jnlt 


(not less than) 




f jle 


(less or equal) 




f jnle 


(not less or equal) 




f jgl 


(greater or less) 




f jngl 


(not greater or less) 




f jgle 


(greater, less or equal) 




f jngle 


(not greater, less or equal) 




f jogt 


(ordered greater than) 




f jule 


(unordered less or equal) 




f joge 


(ordered greater or equal) 




f jult 


(unordered less than) 




f jolt 


(ordered less than) 




f juge 


(unordered greater or equal) 




f jole 


(ordered less or equal) 




f jugt 


(unordered greater than) 




f jogl 


(ordered greater or less) 




f jueq 


(unordered equal) 




f jor 


(ordered) 




f jun 


(unordered) 




fjf 


(false) 




f jt 


(true) 




f jsf 


(signalling false) 




f jst 


(signalling true) 




f jseq 


(signalling equal) 




f jsne 


(signalling not equal) 




f loglOx 


him 


floglOx ea, fn 
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Table B-2 


MC6888 1 Instructions supported by as — Continued 




Mnemonic 


Operation Name 


Syntax 


floglOl 


loglO 


floglOx fm,fn 


f loglOs 




floglO y £ n 


f loglOp 






f loglOw 






floglOd 






floglOb 






f log2x 


lo §2 


flog2x ea, In 


f log21 




flog2x £m,£n 


f log2s 




flog2y ea, In 


flog2p 






f log2w 


log2 ( contd.) 




f log2d 






f log2b 






f lognx 


i°g e 


£ lognx ea,£n 


f lognl 




f lognx fm,fn 


flogns 




f logn y ea, £ n 


f lognp 






f lognw 






f lognd 






f lognb 






f lognplx 


log e (x+l) 


f lognplx ea,£n 


f lognpll 




f lognplx f m, £ n 


f lognpls 




f lognply ea, £ n 


f lognplp 






flognplw 






f lognpld 






f lognplb 






fmodx 


modulo 


fmodx ea, f n 


fmodl 




fmodx f m, f n 


fmods 




fmody ea, f n 


fmodp 






fmodw 






fmodd 






fmodb 






f mo vex 


move fp register 


fmovex ea,£n 


fmovel 




£ mo vex £m,ea 


fmoves 




fmovey ea, £ n 


fmovep 






fmovew 






fmoved 






fmoveb 






fmovecrx 


move constant ROM 


fmovecrx #ccc, £ n 
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Table B-2 


MC6888 1 Instructions supported by as — Continued 




Mnemonic 


Operation Name 


Syntax 


fmovemx 


move multiple data registers 


fmovemy ea, list 


fmoveml 




fmovemx list, ea 


fmovem 




fmoveml ea, dn 






fmovem dn, ea 


fmulx 


multiply 


fmulx ea, f n 


fmull 




fmulx f m, f n 


fmuls 




fmuly ea, f n 


fmulp 






fmulw 


multiply (contd.) 




fmuld 






fmulb 






fnegx 


negate 


fnegx ea, f n 


fnegl 




fnegx tm, f n 


fnegs 




fnegy ea, f n 


fnegp 






fnegw 






fnegd 






fnegb 






fnop 


no operation 


fnop 


fremx 


IEEE remainder 


fremx ea, f n 


f reml 




fremx f m, f n 


frems 




f remy ea, f n 


f remp 






fremw 






f remd 






fremb 






frestore 


restore internal state 


frestore ea 


f save 


save internal state 


fsave ea 


f scalex 


scale exponent 


f scalex ea, f n 


f scalel 




f scalex tm, tn 


f scales 




f scaley ea, tn 


f scalep 






f scalew 






f scaled 






f scaleb 






fscc 


set according to condition 


fscc ea 


f seq 


(equal) 




f sne 


(not equal) 




f sneq 


(not equal or equal) 




f sgt 


(greater than) 




f sngt 


(not greater than) 




f sge 


(greater or equal) 




f snge 


(not greater or equal) 
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Table B-2 


MC6888 1 Instructions supported by a s— 


- Continued 


Mnemonic 


Operation Name 


Syntax 


f sit 


(less than) 




f snlt 


(not less than) 




f sle 


(less or equal) 




f snle 


(not less or equal) 




fsgl 


(greater or less) 




f sngl 


(not greater or less) 




f sgle 


(greater, less or equal) 




f sngle 


(greater, less or equal) 




f sogt 


(not greater, less or equal) 




f sule 


(unordered less or equal) 




f soge 


(ordered greater or equal) 




fsult 


(unordered less than) 




f solt 


(ordered less than) 




f suge 


(unordered greater or equal) 




f sole 


(ordered less or equal) 




f sugt 


(unordered greater than) 




f sogl 


(ordered greater or less) 




f sueq 


(unordered equal) 




fsor 


(ordered) 




f sun 


(unordered) 




f sf 


(false) 




f St 


(true) 




f ssf 


(signalling false) 




f sst 


(signalling true) 




f sseq 


(signalling equal) 




fssne 


(signalling not equal) 




f sgldivx 


single-precision divide 


f sgldivx ea,fn 


fsgldivs 




f sgldivx fm, fn 


f sgldivl 




fsgldivy ea,fn 


f sgldivp 






fsgldivw 






f sgldivb 






f sglmulx 


single-precision multiply 


f sglmulx ea r fn 


f sglmuls 




f sglmulx fm,fn 


fsglmull 




fsglmuly ea,fn 


f sglmulp 






f sglmulw 






f sglmulb 






fsinx 


sin 


fsinx ea, f n 


fsinl 




fsinx fm, fn 


fsins 




fsiny ea,fn 


f sinp 






fsinw 






f sind 
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Table B-2 


MC68881 Instructions supported by as — Continued 




Mnemonic 


Operation Name 


Syntax 


f sinb 


sin 




f sincosx 


simultaneous sine and cosine 


f sincosx ea,fc\fs 


f sincosl 




f sincosx fm, fc:fs 


f sincoss 




fsincos y ea,fc:fs 


fsincosp 






f sincosw 


simultaneous sine and cosine ( contd.) 




f sincosd 






f sincosb 






f sinhx 


hyperbolic sine 


f sinhx ea, f n 


f sinhs 




f sinhx fm , fn 


f sinhp 




fsinhy ea,fn 


f sinhw 






f sinhd 






f s inhb 






f sqrtx 


square root 


fsqrtx ea, fn 


f sqrtl 




f sqrtx fm, fn 


f sqrts 




f sqrty ea, fn 


f sqrtp 






f sqrtw 






f sqrtd 






f sqrtb 






f subx 


subtract 


f subx ea, fn 


f subl 




f subx fm, fn 


f subs 




fsuby ea,fn 


f subp 






f subw 






f subd 






f subb 






ftanx 


tangent 


ftanx ea, fn 


ftanl 




ftanx fm, fn 


ftans 




ft any ea,fn 


ftanp 






ftanw 






ftand 






ftanb 






ftanhx 


hyperbolic tangent 


ftanhx ea, fn 


ftanhl 




ftanhx fm, fn 


ftanhs 




ftanhy ea, fn 



ftanhp 

ftanhw 

ftanhd 

ftanhb 



»SUn 

V microsystems 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic Operation Name Syntax 



ftentoxx 

ftentoxl 

ftentoxs 

ftentoxp 


10 X 


ftentoxx ea, f n 
ftentoxx f m, In 
ftentoxy ea, f n 


ftentoxw 

ftentoxd 

ftentoxb 


10 x (corad.) 




ftrapcc 


trap conditionally 


ft rapcc 


ftrapeq 

ftrapeqw 

ftrapeql 


(equal) 


ftrapcc %data 


ftrapne 

ftrapnew 

ftrapnel 


(not equal) 




ftrapgt 

ftrapgtw 

ftrapgtl 


(greater than) 




ftrapngt 

ftrapngtw 

ftrapngtl 


(not greater than) 




ftrapge 
ftrapgew 
ft rapgel 


(greater or equal) 




ft rapnge 
ftrapngew 
ft rapnge 1 


(not greater or equal) 




ft raplt 
ft rapltw 
ft raplt 1 


(less than) 




ft rapnlt 
ft rapnltw 
ft rapnlt 1 


(not less than) 




ft raple 
ft raplew 
ft raplel 


(less than or equal) 




ft rapnle 
ft rapnlew 
ft rapnlel 


(not less than or equal) 




ft rapgl 
ftrapglw 
ft rapgl 1 


(greater than or less) 




ftrapngl 
ft rapnglw 
ftrapngll 


(not greater than or less) 




ft rapgle 


(greater, less or equal) 





r microsystems 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic Operation Name Syntax 

ft rapt w 
ft rapt 1 

ft raps f (signalling false) 

ft rapt w 

ftrapsfl 

ftrapst (signalling true) 

ftrapsfw 

ft rapstl 

ftrapseq (signalling equal) 

ftrapseqw 

ftrapseql 

ft rapsne (signalling not equal) 

ft rapsnew 

ftrapsnel 



ftstx 
ftstl 
ftsts 
ft stp 
ftstw 
ftstd 
ftstb 


test operand 


ftstx ea 
ftstx f m 
ft sty ea 


ftwotoxx 


2 X 


ftwotoxx ea,fn 


ftwotoxl 




ftwotoxx f m, In 


ftwotoxs 




ftwotoxy ea, f n 



ftwotoxp 

ftwotoxw 

ftwotoxd 

ftwotoxb 
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FPA Assembler Syntax 



This appendix describes the Sun Floating-Point Accelerator (FPA) support exten- 
sions to as included in Sun software release 3.1 and later. 

The extensions to as are described in general, with discussions of two-, three-, 
and four-operand instruction examples. Some instructions covered separately 
don’t follow the formats described at the beginning of the appendix. The appen- 
dix includes restrictions and potential errors, followed by a summary of sup- 
ported floating-point instructions. 

C.l. Instruction Syntax The general format for floating-point instructions is 













fpopt0A 


operands 




v 






j 



where 

f p indicates an FPA instruction. 
op is the opcode name. 

t is the operand type, either single (s) or double (d). 

The 0 A part of the instruction is optional. When present, A specifies the address 
register which contains the base address for the FPA and can be in the range 0..7. 
If this form is used, a previous instruction must load the FPA address 
(OxeOOOOOOO) into the specified address register. 

If @A is not present, then absolute long addressing is used to refer to the FPA. 
This form is more efficient for short routines. 

Depending on the instruction, there may be from zero to four operands specified. 
The operands can be any of the following forms: 

□ Any MC68020 effective address, with the exception that absolute short 
addresses are not allowed for double-precision values. 



□ If either of the data register or the address register is used to hold a double- 
precision value, then the value will be in a register pair and both registers, 
separated by a colon, must be specified in the instruction. For example: 



c ~ 




a 




fpaddd dO:dl, fpaO 








) 




sun 

microsystems 
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C.2. Register Syntax 



C.3. Operand Types 



C.4. Two-Operand 
Instructions 



The only exception to this rule is the fpltod instruction (convert integer to 
double-precision value). 

□ In some instructions (command register type) it is possible to specify that the 
register be in constant RAM. The syntax used for this case is %n, where n is 
a register number in the range 0 to 51 1. 

The 32 floating-point data registers are designated f paO , f pal , . . . , 
fpa31. The supported control registers are: 



Hardware 


Software 


MODE3_0 


fpamode 


WSTATUS 


fpastatus 



as supports three floating-point operand types: 

□ s for single-precision floating-point operands. 

□ d for double-precision floating-point operands. 

□ 1 for 32-bit integer operands, used for integer to floating-point conversions. 



Opcodes such as add, subtract, multiply, divide, negate, absolute value, square 
root, conversion from integer to floating-point, conversion from single to double 
(and vice versa) are all represented as: 



/■ 




fp opt X, fpa n 




\ 


J 



where t= s or d, and X is any valid MC68020 effective address for an operand or 
is an FPA data register. 

If X is an FPA register which is in the constant RAM, then it can be in the range 
0 to 51 1. If it is not in constant RAM, then it is one of the 32 FPA data registers. 
If X is an FPA register, then f pan is one of the 32 floating-point data registers. 
If X is an effective address, then f pan is one of the FPA registers in the range 0 
to 15. The following are examples of such instructions: 



r 




a 




Instruction 


Computes 


fpnegs 


<ej ffective address> , fpa 1 




fpsqrd 


<effective address> , fpa2 




fpsubs 


fpal, fpa2 


fpa2 <- fpa2 - fpal 


fprsubs 


fpal, fpa2 


fpa2 <- fpal - fpa2 


fpdivs 


dO, fpa2 


fpa2 <— fpa2 / dO 


fprdivs 


dO, fpa2 


fpa2 «- dO / fjpa2 


V 




J 



In the above examples f prsubs and fprdivs are the reverse subtract and 
reverse divide operators, respectively. 
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The opcodes for sine, cosine, atan, e^x, e~x-l, ln(x), 

In ( 1 +x ) , s qr t ( x ) , and s inco s ( x ) are all supported as command- 
register type instructions: 



r 


'N 


fp opt fpax, fpan 

v 


J 



where t = s or d. 

f pax is either a floating-point register or a register in the constant RAM (which 
is specified as % number ). For the sine os instruction, the destination operand 
is actually a register pair: 



r 


A 


fpsincosf fpax, fpac:fpas 




v 


) 



C.5. Three-Operand 
Instructions 



where fpac is the cosine’s destination and f pas is the sine’s destination. 

The opcodes are supported in extended and command-register forms as 



— 




\ 


fpop3t 


X, fpam, fpan 




v. 




) 



where t = s or d and X is an <effective address> for an extended instruction or 
a floating-point register for a command-register type of instruction. 

In the command-register form, X and fpam can indicate a register number in 
the constant RAM. That is, they can either be in the range 0 to 5 1 1 or in the 
range 0 to 31. In the extended instruction form, fpam and fpan must be in 
the range 0 to 15. In the above format the positions of X and fpam can be 
exchanged for the commutative operators add and multiply (the result of the 
operation remains the same). 



For example, 



r 

fpa2 <— <effective address> 4- fpal 


\ 


V 


J 



can be represented by either of the following forms: 



r — 


fpadd3s 


<effective address > , fpal. 


fpa2 


\ 




fpadd3s 


fpal, <ejfective address > , 


fpa2 




v 








J 



The same rule applies to subtract and divide operations. However, they are not 
commutative, so different answers result from each order. For example, 



f 

fpa2 <— fpal - <effective address> 




\ 


) 



must be coded as: 




r 

fpsub3s <effective address> , fpal, fpa2 


A 


V 


J 
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whereas 

fpa2 <— <effective address> - fpal 

> 

must be coded as: 



fpsub3s fpal, <effective address> , fpa2 

s > 



Following the same format. 



( 


\ 


fpa3 <— fpa2 - fpal 




V 


* 



must be coded as: 





fpsub3s fpal, fpa2, fpa3 




V 




J 



C.6. Four-Operand In the extended and command-register formats there are pivot instructions of the 



Instructions 


form: 








s 




fp opt X, fpax, fpay, fpan 






^ 


J 



where f paw is the destination floating-point data register, t = s or d, and X is 
an effective address or a floating-point register. 

In the extended form, the positions of X and fpay can be exchanged for both 
single- and double -precision types of instructions. In single-precision extended 
form, it is possible for two of the four operands to be effective addresses. This is, 
in general, either the first and third or the second and third operands. 

In the command register form, fpax and f pay can be replaced by %x and %y 
indicating register numbers x and y in the constant RAM. 

For four-operand instructions, f pax, f pay and f pan can each be in the range 
0 to 15 when X is an effective address. If X is an FPA register, then X and f pan 
must be in the range 0 to 3 1 and f pax and f pay can either be in the range 0 to 
511 (designating a location in constant RAM) or else in the range 0 to 31. 

These pivot instructions are rather complicated and will be dealt with com- 
pletely. The following shows the forms of each operation, the assembly code 
equivalent to each form, a generalization of the assembly instruction and a 
sequence of operations equivalent to the pivot instruction. 
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r 


Instruction 




Meaning 




f pma { s , d } 


<ej ifective address> , reg2 , reg3 , 


regl 


regl <— reg3 + (reg2 * operand) 




f pma { s , d } 


reg2 , r eg3 , <effecti\e address > , 


regl 


regl <— operand + (reg3 * reg2) 




f pma { s , d } 


reg4, reg2, reg3, regl 




regl <r- reg3 + (reg2 * reg4) 




fpmas 

v 


<eal>, reg2, <ea2>, regl 




regl <— operand2 + (reg2 * operandl) 


J 



The f pma instruction, where m stands for multiply, and a stands for add, can 
be generalized as 




where t is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. Also, for single precision either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 



— 


"j 


fpmas dO, fpal, fpa2, fpa3 




l 


J 



is equivalent to the following sequence of instructions 



— 




'N 


fpmul3s 


dO, fpal, temp 




fpadd3s 


temp, fpa2, temp 




fpmoves 


temp, fpa3 




V 




J 



where temp is a temporary register. 



Instruction 



Meaning 



fpms { s, d} 
fpms fs,d) 
fpms { s, d} 
fpmss 



<effective address> , reg2 , reg3, regl 
reg2, reg3, <effective address > , regl 
reg4, reg2, reg3, regl 
<eal>, reg2 , <ea2>, regl 



regl <- reg3 - (reg2 * operand) 
regl <- operand - (reg3 * reg2) 
regl <- reg3 - (reg2 * reg4) 
regl <— operand2 - (reg2 * operandl) 



The fpms instruction, where m stands for multiply, and s stands for subtract, 
can be generalized as 





— 


fpms? X, fpax, fpay, fpan 




V 


) 



where t is s or d, and X is an effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. Also, in single-precision two-memory instructions, either the 
first and third operands or the second and third operands can be effective 
addresses. Note that, for example, 



t 





fpmss fpal, fpa2, dO, fpa3 






J 
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is equivalent to the following sequence of instructions 



— 

fpmul3s 


fpal. 


fpa2, temp 





fpsub3s 


temp, 


dO , temp 




fpmoves 


temp. 


fpa3 




v 






J 



The f pmr instruction, where m stands for multiply, and r stands for reverse 
subtract, can be generalized as 

. 

fpmrf X, fpax, fpay, fpan 

s ^ 



where t is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. 



— 


Instruction 




— 

Meaning 


f pmr { s , d } 


<effective address> , reg2, reg3. 


regl 


regl <— (-reg3) + (reg2 * operand) 


f pmr { s , d } 


reg2 , reg3 , <effective address > , 


regl 


regl 4— (-operand) + (reg3 * reg2) 


f pmr { s , d } 


reg4, reg2, reg3, regl 




regl <- (-reg3) + (reg2 * reg4) 


fpmrs 


<eal>, reg2, <ea2>, regl 




regl <— (-operand2) + (reg2 * operandl) 


v 






J 



In single-precision extended form either the first and third operands or the second 
and third operands can be effective addresses. Note that, for example, 



r 

fpmrs dO, fpal, fpa2, fpa3 


> 


v 


J 



is equivalent to the following sequence of instructions: 



r 




\ 


fpmul3s 


dO, fpal, temp 




fpsub3s 


fpa2, temp, temp 




fpmoves 


temp, fpa3 




V 




J 



The f pam instruction, where a stands for add, and m stands for multiply, can 
be generalized as 



r 




fpam/ X, fpar, fpay, fpan 




V 


J 



where t is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. 



#sun 

V microsystems 
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— 


Instruction 




-v 

Meaning 


fpam{ s, d} 


<effective address> , reg2 , reg3 , 


regl 


regl <— reg3 * (reg2 + operand) 


fpam{ s, d} 


reg2, reg3, <effective address> , 


regl 


regl <— operand * (reg3 + reg2) 


fpam{ s, d} 


reg4, reg2, reg3, regl 




regl <— reg3 * (reg2 + reg4) 


fpams 

v 


<eal>, reg2, <ea2> , regl 




regl <— operand2 * (reg2 + operandl) 

j 



In single-precision two-memory instructions, either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 



fpams fpal, fpa2, fpa3, fpa4 

k. 




is equivalent to the following sequence of instructions: 




r 

fpadd3s fpal, fpa2, temp 

fpmul3s temp, fpa3, temp 


"N 


fpmoves temp, fpa4 

V 


J 


The fpsm instruction, where s stands for subtract, and 
can be generalized as 


m stands for multiply, 


fpsmf X, fpax, fpay, fpan 




v 





where t is s or d, and X is an effective address or one of the floating-point data 
registers. In the extended type of instruction, the positions of X and f pay can 
be exchanged. The special cases for single-precision instructions are that either 
the first and third operands or the second and third operands can be effective 
addresses. 



( 


Instruction 




Meaning 





fpsm{ s, d} 


<effective address> , reg2, reg3, 


regl 


regl <— reg3 * (reg2 - operand) 




fpsm{ s, d} 


reg2, reg3, <effective address > , 


regl 


regl <— operand * (reg3 - reg2) 




fpsm{ s, d} 


reg4, reg2, reg3, regl 




regl reg3 * (reg2 - reg4) 




fpsm{ s, d} 


reg2 , <effective address> , reg3 , 


regl 


regl <— reg3 * (-reg2 + operand) 




fpsm{ s, d} 


reg2, reg4, reg3, regl 




regl <— reg3 * (-reg2 + reg4) 




fpsms 


<eal>, reg2, <ea2>, regl 




regl <— operand2 * (reg2 - operandl) 




fpsms 

V 


reg2, <eal>, <ea2>, regl 




regl <— operand2 * (-reg2 + operandl) 


> 



Note that, for example, 



/ 

fpsms dO, fpal, fpa2, fpa3 




v 


J 



is equivalent to the following sequence of instructions: 
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r 






fpsub3s 


dO, fpal, temp 




fpmul3s 


temp, fpa2, temp 




fpmove s 


temp, fpa3 




V 




J 



C.7. Other Instructions Other special instructions are listed below. In each of them the last operand is 

also the destination, except for tst, cmp and mcmp where f pas tat us is 
the implied destination. X is either an effective address or an FPA data register 
and t is either s or d for all instructions except f pmovef, where t can be s, 
d, or 1. 



T able C- 1 Other Instructions 



Mnemonic 


— 

Operand 


Operation Name 


fpnop 




nop 


f ptstf 


X 


operand compare with zero 


fpcmpf 


X, fpam 


register m compare with operand 


fpmcmpf 


X, fpam 


register m compare magnitude with operand 


f pmovef 


fpam, fpan 


move floating-point register 


fpmove2f 


fpam, fpan 


2x2 matrix move 


fpmove3f 


fpam, fpan 


3x3 matrix move 


f pmove4f 


fpam, fpan 


4x4 matrix move 


fpdot2f 


fpax, f pay, fpan 


fpan <— fpax*fpay (fpa x+1) * (fpa y+1) 


fpdot3f 


fpax, f pay, fpan 


fpan <— fpax*fpay (fpax-f 1) * (fpay+i) + 
(fpax+2) * (fpa y+2) 


fpdot4f 


fpax, f pay, fpan 


fpan <— f pax*fpay (fpax-f i)*(fpay-fi) + 
(fpax+2)*(fpay-f2) (fpax-f 3)*(fpay +3) 


fptran2f 


fpam, fpan 


transpose 2x2 matrix 


fptran3f 


fpam, fpan 


transpose 3x3 matrix 


fptran4f 


fpam, fpan 


transpose 4x4 matrix 


fpmove 


fpamode, <ea> 


read mode register 


fpmove 


<ea>, fpamode 


write to mode register 


fpmove 


fpastatus, <ea> 


read status register 


fpmove 


<ea>, fpastatus 


write to status register 


f pmovef 


fpam, <ea> 


read a floating-point data register 


f pmovef 


<ea>, fpan 


write to a floating-point data register 



C.8. Restrictions and In double-precision instructions, when absolute short addressing or a single data 

Errors or address register is used, as reports an invalid operand error. 

For the dot product and matrix move and transpose instructions, when the regis- 
ter specified does not fall within the specified range, as reports a register-out- 
of-range error. 
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For most instructions where one operand is an effective address, the register 
range is 0 to 15. If all operands are FPA registers, then the register range is 0 to 
3 1 . For constant RAM registers, the range is 0 to 5 1 1 . as reports an invalid 
operand error when any of these registers are not within the permitted range. 

C.9. Instruction Set In the following table, X is any valid MC68020 or MC68030 effective address 

Summary (the form ( xxx ) : w is not allowed for double) or FPA register. In some three- or 

four- address instructions the position of the X and one of the FPA registers can 
be exchanged. This is shown in the fourth column of the following table. 



Table C -2 Floating-Point I nstructions 



Instruction 


Operand 


Operation 


Alternative 


f pnegs 


X, fpan 


negate single 




f pnegd 


X, fpan 


negate double 




fpabss 


X, fpan 


absolute value single 




f pabsd 


X, fpan 


absolute value double 




f pltos 


X, fpan 


convert integer to single 




f pltod 


X, fpan 


convert integer to double 




fpstol 


X, fpan 


convert single to integer 




f pdtol 


X, fpan 


convert double to integer 




f pstod 


X, fpan 


convert single to double 




f pdtos 


X, fpan 


convert double to single 




fpsqrs 


X, fpan 


square single 




fpsqrd 


X, fpan 


square double 




f padds 


X, fpan 


add single 




f padd3s 


X, fpam, fpan 


add single 


fpam, X, fpan 


fpaddd 


X, fpan 


add double 




f padd3d 


X, fpam, fpan 


add double 


fpam, X, fpan 


fpsubs 


X, fpan 


subtract single 




f psub3s 


X, fpam, fpan 


subtract single 


fpam, X, fpan 


fprsubs 


<ea>, fpan 


reverse subtract single 




fpsubd 


X, fpan 


subtract double 




fpsub3d 


X, fpam, fpan 


subtract double 


fpam, X, fpan 


fprsubd 


<ea> , fpan 


reverse subtract double 




fpmuls 


X, fpan 


multiply single 




fpmul3s 


X, fpam, fpan 


multiply single 


fpam, X, fpan 


f pmuld 


X, fpan 


multiply double 




f pmul3d 


X, fpam, fpan 


multiply double 


fpam, X, fpan 


f pdivs 


X, fpan 


divide single 




fpdiv3s 


X, fpam, fpan 


divide single 


fpam, X, fpan 


fprdivs 


<ea>, fpan 


reverse divide single 
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Table C-2 Floating-Point Instructions — Continued 



Instruction 


Operand 


Operation 


Alternative 


fpdivd 


X, fpa n 


divide double 




fpdiv3d 


X, fpam, fpan 


divide double 


fpam, X, fpan 


fprdivd 


<ea>, fpa n 


reverse divide double 




fpnop 




nop 




fptsts 


X 


single compare with 0 




fptstd 


X 


double compare with 0 




fpcmps 


X, fpam 


single compare 




fpcmpd 


X, fpam 


double compare 




fpmcmps 


X, fpam 


single magnitude compare 




fpmcmpd 


X, fpam 


double magnitude compare 




fpsins 


fpa*, fpan 


sine single 




fpsind 


fpa*, fpan 


sine double 




fpcoss 


fpa*, fpan 


cosine single 




fpcosd 


fpa*, fpan 


cosine double 




fpatans 


fpa*, fpan 


atan single 




fpatand 


fpa*, fpan 


atan double 




fpetoxs 


fpa*, fpan 


e A x single 




fpetoxd 


fpa*, fpan 


e A x double 




fpetoxmls 


fpa*, fpan 


e A x-l single 




f petoxmld 


fpa*, fpan 


e A x-l double 




fplogns 


fpa*, fpan 


ln(x) single 




fplognd 


fpa*, fpan 


ln(x) double 




fplognpls 


fpa*, fpan 


ln(l+x) single 




fplognpld 


fpa*, fpan 


ln(l+x) double 




fpsincoss 


fpa*, fpac:fpas 


fpac <— cosine(x), fpas <— sine (x) 




fpsincosd 


fpa*, fpactfpas 


fpac <— cosine(x), fpa s <— sine (x) 




fpmas 


X, fpa*, fpay, fpan 


fpan <— (fpa* * X) + fpay 


fpa*, X, fpay, fpan 








fpay, fpa*, X, fpan 








X, fpa*, X, fpan 








fpa*, X, X, fpan 


fpmad 


X, fpa*, fpay, fpan 


fpan <— (fpa* * X) + fpay 


fpa*, X, fpay, fpan 








fpay, fpa*, X, fpan 


fpmss 


X, fpa*, fpay, fpan 


fpan <r- fpay - (fpa* * x) 


fpa*, X, fpay, fpan 








fpay, fpa*, X, fpan 








X, fpa*, X, fpan 








fpa*, X, X, fpan 


fpmsd 


X, fpa*, fpay, fpan 


fpan <— fpay - (fpa* * x) 


fpa*, X, fpay, fpan 








fpay, fpa*, X, fpan 


fpmrs 


X, fpa*, fpay, fpan 


fpan <— (fpa* * x) - fpay 


fpa*, X, fpay, fpan 








fpay, fpa*, X, fpan 








X, fpa*, X, fpan 








fpa*, X, X, fpan 


fpmrd 


X, fpa*, fpay, fpan 


fpan <— (fpa* * x) - fpay 


fpa*, X, fpay, fpan 








fpay, fpa*, X, fpan 
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Table C-2 Floating-Point Instructions — Continued 



Instruction 


Operand 


Operation 


Alternative 


fpams 


X, fpax, fpay, fpan 


fpan 4— (fpax + x) * fpay 










fpax, X, fpay, fpan 








fpay, fpax, X, fpan 








X, fpax, X, fpan 








fpax, X, X, fpan 


fpamd 


X, fpax, fpay, fpan 


fpan 4 — (fpax + x) * fpay 










fpax, X, fpay, fpan 








fpay, fpax, X, fpan 


fpsms 


X, fpax, fpay, fpan 


fpan 4 — (fpax - x) * fpay 










fpax, X, fpay, fpan 








fpay, fpax, X, fpan 








X, fpax, X , fpan 








fpax, X, X, fpan 


fpsmd 


X, fpax, fpay, fpan 


fpan <— (fpax - x) * fpay 










fpax, X, fpay, fpan 








fpay, fpax, X, fpan 


fpmoves 


<ea>, fpan 


write to a register, single 




fpmoved 


<ea>, fpan 


write to a register, double 




fpmovel 


<ea>, fpan 


write to a register, integer 




fpmoves 


fpam, <ea> 


read a register, single 




fpmoved 


fpam, <ea> 


read a register, double 




f pmove2 s 


fpam, fpan 


2x2 matrix move, single 




fpmove2d 


fpam, fpan 


2x2 matrix move, double 




fpmove3s 


fpam, fpan 


3x3 matrix move, single 




fpmove3d 


fpam, fpan 


3x3 matrix move, double 




fpmove4s 


fpam, fpan 


4x4 matrix move, single 




fpmove4d 


fpam, fpan 


4x4 matrix move, double 




fpdot2s 


fpax, fpay, fpan 


fpan 4 — fpax* fpay + (fpax -4-7) * (fpa y+1) 




fpdot2d 


fpax, fpay, fpan 


fpan 4— fpax*fpay + (fpax-4-7) * (fpay-4-7) 




fpdot3s 


fpax, fpay, fpan 


fpan 4— fpax*fpay + (fpax-4-7) * (fpay+7) + 








(fpax+2) * (fpay-4-2) 




fpdot3d 


fpax, fpay, fpan 


fpan 4— fpax* fpay + (fpax -4-7) * (f pay-4-7) + 








(fpa x-4-2) * (fpay-4-2) 




fpdot4s 


fpax, fpay, fpan 


fpan 4- fpax*fpay + (fpax-4-7) * (fpay+7) + 








(f pax -4-2) * (fpay-4-2) + ( f pax-4-3 )* (f pay-4-3) 




fpdot 4d 


fpax, fpay, fpan 


fpan 4— fpax*fpay + ( fpax -4-7 )* (f pay-4-7) + 








(fpax+2) * (fpay+2) + (fpax-4-3) * (fpay-4-3) 




fptran2s 


fpam, fpan 


transpose 2x2 matrix, single 




fptran2d 


fpam, fpan 


transpose 2x2 matrix, double 




fptran3s 


fpam, fpan 


transpose 3x3 matrix, single 




fptran3d 


fpam, fpan 


transpose 3x3 matrix, double 




fptran4s 


fpam, fpan 


transpose 4x4 matrix, single 




fptran4d 


fpam, fpan 


transpose 4x4 matrix, double 
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Table C-2 Floating-Point Instructions — Continued 



Instruction 


Operand 


Operation 


Alternative 


fpmove 


f pamode , <ea> 


read the mode register 




fpmove 


<ea>, f pamode 


write on mode register 




fpmove 


fpastatus, <ea> 


read the status register 




fpmove 


<ea>, fpastatus 


write to status register 





Table C-3 FPA+ Instructions 

The original FPA used the Weitek 1 164/1165 floating-point chip set. The newer FPA+ is based on the TI 8847 chip, 
and supports floating-point operations on variables of complex type, and square root. The new complex math instruc- 
tions operate only on double precision values. 

You can see examples of floating point coprocessor usage in /usr/lib/f 688 81, /usr/lib/f fpa, and 
/ usr/ lib/f fpaplus. 



Instruction 


Operand 


Operation 


fpsqrt s 
fpsqrtd 


d0 , f pan 
dO : dl , f pan 


square root 


fphypots 

fphypotd 


al@, fpa/n, fpan 
aO0 , fpam, fpan 


hypoteneuse 


fpcnegd 


a0@, fpan 


complex negation 


fpcabsd 


a0@ , fpa m 


complex absolute value 


fpcaddd 


a0@, fpam, fpan 


complex add 


fpcsubd 


a0@, fpa m, fpan 


complex subtraction 


fpcmuld 


a0@, fpa m, fpan 


complex multiply 


fpcdivd 


a0@ , fpam, fpan 


complex division 
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